andFilterWhere()会忽略null、''、[]、0和false等值，导致业务上需查询的空格、状态0、非法日期等被跳过，应结合手动判断或andWhere()避免误过滤。
Yii2 的 andFilterWhere() 确实会自动跳过空值，但“空值”的判定规则和业务语义不匹配时，就容易出问题。不是所有看起来“没填”的字段都该被忽略——关键得看你的业务逻辑是否允许它为空、是否需要查“空值本身”。
哪些值会被 andFilterWhere 自动忽略
它识别的“空值”包括：
- null
- 空字符串 ''（注意：包含空格的字符串如 ' ' 经 trim() 后也会变为空字符串）
- 空数组 []
- 数值 0 和布尔 false（仅在哈希格式中，如 ['status' => 0] 会被跳过；但 ['>=', 'status', 0] 不会被跳过，因为是操作符格式）
典型踩坑场景
-
搜索用户名为“空格”的记录：用户输入一个空格，后端
trim($name)后变成''，andFilterWhere(['username' => $name])直接失效，结果查出全部用户。解决办法是手动判断：if ($name !== '' || $name === ' ') { $query->andWhere(['username' => $name]); } -
状态字段默认值是 0，但 0 是有效状态：表单提交
status=0，用andFilterWhere(['status' => $status])会导致条件被丢弃，查不到 status=0 的数据。应改用andWhere()或显式判断：if ($status !== null) { $query->andWhere(['status' => $status]); } -
日期范围筛选中起始时间为空：只填了
$end没填$start，写成andFilterWhere(['>=', 'created_at', $start])看似安全，但如果$start是非法格式（如'abc'），可能生成WHERE created_at >= 'abc'，触发全表扫描甚至报错。务必先验证时间格式或设默认值。
关联字段搜索时的隐藏陷阱
比如要按用户所属部门名称搜索：$query->joinWith('department')->andFilterWhere(['department.name' => $deptName]);
如果 $deptName 为空，andFilterWhere 会跳过这个条件，但 joinWith 仍会执行——这可能导致 LEFT JOIN 变成 INNER JOIN 效果（取决于数据库和 join 类型），意外过滤掉无部门的用户。正确做法是把 join 和条件绑定在一起：
if (!empty($deptName)) {<br>
$query->joinWith('department')->andFilterWhere(['department.name' => $deptName]);<br>
}
调试建议
遇到查询结果不符合预期时，别只看 PHP 代码，直接打印最终 SQL：echo $query->createCommand()->getRawSql();
再对比你传入的参数值类型（用 var_dump($param) 确认是不是 null、'' 还是 '0' 字符串）。很多问题其实出在前端传参或表单模型 load 时的类型转换上。
