SearchModel::search()中where条件没生效的最常见原因是andFilterWhere()传入空值或null时静默跳过，不生成SQL片段；关联字段报错需显式joinWith()，日期范围需手动拆分字符串，排序路径字段需提前关联并用别名映射。
SearchModel::search() 里 where 条件没生效，SQL 中根本没出现
最常见原因是 andFilterWhere() 传了空值或 null —— 它会跳过整个条件，不生成 SQL 片段。比如用户没填时间范围，$params['created_at_from'] 是空字符串或未定义，andFilterWhere(['>=', 'created_at', $value]) 就静默忽略，而不是生成 created_at >= '' 这种无效语句。
真正要拼进去的条件，得用 andWhere() 或显式判断：
- 对必填字段（如状态枚举），用
andFilterWhere(['status' => $this->status])安全 - 对可选范围查询（如时间区间），先判空再拼：
if ($this->created_at_from) { $query->andFilterWhere(['>=', 'created_at', $this->created_at_from]); } - 别在
andFilterWhere里直接传$_GET原始值——它可能带空格、非法字符，必须经模型规则验证后才可信
关联字段搜索报错 “Unknown column 'profile.status'”
错误不是字段名写错，而是没显式 joinWith()。ActiveRecord 的 andFilterWhere() 不会自动把关联表拖进来，profile.status 在主表 user 里当然不存在。
正确做法是在 search() 开头就声明关联：
-
$query = self::find()->joinWith(['profile']);—— 注意是self::find()，不是User::find() - 如果关联是延迟加载（lazy loading），必须用
joinWith('profile', true)强制 inner join，否则 left join 下profile.status可能为 null 导致筛选失效 - 字段别名要统一：查
profile.status就别在 rules 里写profile_status，否则load()不会赋值过去
日期范围筛选传入 '2024-01-01/2024-12-31' 却查不到数据
这是 datetimepicker 插件典型坑：它把起止时间合成一个斜杠分隔字符串，但模型没拆解，直接拿整个字符串去 andFilterWhere()，结果生成 WHERE created_at = '2024-01-01/2024-12-31' —— 显然永远不匹配。
解决方式不是改视图，而是改 SearchModel：
- 在模型里加两个虚拟属性：
public $created_at_range;和public $created_at_from;、public $created_at_to; - 在
rules()中声明：[['created_at_range'], 'safe']，并加自定义验证器拆分字符串 - 在
search()中手动解析：if (!empty($this->created_at_range)) { [$from, $to] = explode('/', $this->created_at_range); $query->andFilterWhere(['between', 'created_at', $from, $to]); }
排序字段 user.profile.name 不生效或报错
ActiveDataProvider 默认只允许对主表字段排序，user.profile.name 这种路径写法会被当成字面量，不触发 join，也不校验字段存在性。
必须提前在 query 中完成关联，并用 addSelect() 暴露字段：
$query = self::find()->joinWith(['profile'])->addSelect(['user.*', 'profile.name as profile_name']);- 然后排序用真实别名：
$dataProvider->sort->attributes['profile_name'] = ['asc' => ['profile.name' => SORT_ASC], 'desc' => ['profile.name' => SORT_DESC]]; - 注意：别名字段不能直接进
andFilterWhere()，仍要用原始字段名profile.name，否则 SQL 语法错
yii\db\Connection::enableLogging = true，看最终生成的 SQL —— 大多数“条件没生效”问题，本质都是 SQL 里压根没那行 WHERE。 
