CakePHP 的 where([]) 不生成 WHERE 子句，后续 andWhere() 会因无前置 WHERE 而报错；空值需手动过滤；多条件逻辑须用闭包分组；关联表条件必须在 contain() 或 join 后设置。
where() 传空数组会生成 WHERE 1=1 吗？
不会。CakePHP 的 where() 方法接收空数组时，**不添加 WHERE 子句**，最终 SQL 里根本不会有 WHERE 关键字——这和 Laravel 或 ThinkPHP 的行为不同，也意味着你不能靠“空数组兜底”来避免语法错误。
但问题出在链式调用：如果你写了 $query->where([])->andWhere(['status' => 1])，andWhere() 会尝试在不存在的 WHERE 后追加 AND，导致 SQL 报错：SQLSTATE[HY000]: General error: 1 near "AND": syntax error。
- 空数组传给
where()是安全的，等价于没调用 -
andWhere()必须确保前面已有有效where()、orWhere()或having() - 别用
where([])当占位符，它不创建“初始 WHERE”
动态拼接条件时 andWhere() 怎么防空值？
CakePHP 不自动过滤 null、''、[] 这类值。比如 $query->andWhere(['title' => $input['title']])，当 $input['title'] === '' 时，会生成 AND title = ''，这不是漏查，而是查了不该查的数据。
正确做法是显式过滤后再调用：
立即学习“PHP免费学习笔记（深入）”；
- 用
array_filter($conditions, function($v) { return $v !== null && $v !== '' && $v !== []; })清洗数组 - 对数字字段（如
status），单独判断是否为0：用is_numeric($v) || $v === 0，避免!empty(0)误判 - 多字段 OR 模糊搜索别硬塞进
andWhere()，改用闭包分组：$query->andWhere(function ($exp) use ($keyword) { return $exp->or_(['title LIKE' => "%{$keyword}%", 'content LIKE' => "%{$keyword}%"]); })
andWhere() 和 where() 混用顺序错了会怎样？
顺序直接影响 SQL 逻辑优先级。CakePHP 的 andWhere() 总是追加到当前 WHERE 表达式的最外层，不自动加括号。写成：
$query->where(['active' => 1])
->andWhere(['type' => 'user'])
->orWhere(['role' => 'admin']);
生成的是：WHERE active = 1 AND type = 'user' OR role = 'admin' —— 注意，OR 和前面整个 AND 组是平级的，不是 (active = 1 AND type = 'user') OR role = 'admin'。
- 想实现“（A 且 B）或 C”，必须用闭包包裹前两个条件：
->where(function ($exp) { return $exp->and_(['active' => 1, 'type' => 'user']); })->orWhere(['role' => 'admin']) -
andWhere()和orWhere()不能交叉混用而不分组，否则语义失控 - 调试时用
$query->sql()看原始 SQL，别只信 PHP 代码缩进
关联查询里用 andWhere() 过滤关联表字段为何失效？
直接在主查询上 andWhere(['posts.status' => 1]) 通常无效，因为 CakePHP 默认不自动 JOIN 关联表。它只会把字段名原样塞进 WHERE，而数据库找不到 posts.status（除非你手动 contain() 并指定 joinType）。
正确方式只有两种：
- 在
contain()闭包里加条件：->contain(['Posts' => function ($q) { return $q->where(['posts.status' => 1]); }]) - 显式
leftJoinWith('Posts')后再andWhere()，但要确认posts别名是否匹配（默认是表名小写） - 关联模型启用了软删除？得在闭包里额外加
->where(['posts.deleted_at IS NULL'])，withTrashed()不适用于contain()场景
最容易被忽略的是：关联条件写在主查询的 andWhere() 里，既不报错也不生效，静默丢弃——得靠 debug($query->sql()) 才能发现字段压根没出现在生成的 SQL 中。
