Yii 2 中 orWhere() 连续调用会导致逻辑错误，因其将每个条件视为顶层 OR 分支，而非嵌套在前一 where 的 AND 下；正确做法是用 andWhere(['or', ...]) 或闭包嵌套 orFilterWhere 实现括号分组，确保 SQL 语义准确。
Yii2 查询构造器中 orWhere() 直接拼接会导致 SQL 逻辑错误，根本原因是 AND 和 OR 的优先级被忽略——OR 会“突破”原有 AND 分组，把整个条件变成宽松匹配。
问题典型表现
比如想查：状态为 draft 且（标题包含关键词 或 内容包含关键词），错误写法：
$query = Article::find()
->where(['status' => 'draft'])
->orWhere(['like', 'title', $kw])
->orWhere(['like', 'content', $kw]);
生成的 SQL 实际是：
WHERE `status` = 'draft' OR `title` LIKE '%kw%' OR `content` LIKE '%kw%'
结果：所有草稿、所有标题含关键词、所有内容含关键词的记录全被查出，完全偏离本意。
正确解法：用 andWhere + orFilterWhere 组合嵌套
核心思路是让 OR 条件整体作为 AND 下的一个子单元。推荐两种安全写法：
-
用
andFilterWhere()配合匿名函数 +orFilterWhere()（推荐，自动处理空值）：
$query = Article::find()->where(['status' => 'draft']);
$query->andFilterWhere(function ($q) use ($kw) {
$q->orFilterWhere(['like', 'title', $kw])
->orFilterWhere(['like', 'content', $kw]);
});
-
手动构建括号组：用
andWhere()包裹数组形式的 OR 条件：
$query = Article::find()
->where(['status' => 'draft'])
->andWhere([
'or',
['like', 'title', $kw],
['like', 'content', $kw],
]);
生成 SQL 是：
WHERE `status` = 'draft' AND (`title` LIKE '%kw%' OR `content` LIKE '%kw%')
为什么不能只用 orWhere() 连续调用？
因为 Yii2 的查询构造器默认把每个 orWhere() 视为顶层 OR 分支，不会自动归入上一个 where() 的 AND 上下文中。它不是“追加到上个条件右边”，而是“和整个前面条件做 OR”。这符合 SQL 语义，但容易误读成“在当前组里加 OR”。
进阶提醒：混合 AND/OR 时务必显式分组
更复杂的场景，例如：（状态为 draft 或 archived）且（标题或内容含关键词）且（作者ID不为空），必须分层嵌套：
$query = Article::find()
->andWhere(['in', 'status', ['draft', 'archived']])
->andWhere([
'or',
['like', 'title', $kw],
['like', 'content', $kw],
])
->andWhere(['not', ['author_id' => null]]);
切忌混用 where() / orWhere() / andWhere() 不加结构控制——一旦出现 OR，就该立刻考虑是否需要用数组语法或闭包把它“括起来”。
