gridview自定义列必须同步配置searchmodel，否则筛选失效；需在searchmodel中定义虚拟属性、joinwith关联、andfilterwhere过滤，并在列配置中用attribute=>虚拟属性名而非关联路径。
GridView 自定义列必须配 SearchModel，否则筛选失效
只改 columns 配置、不碰 SearchModel，表面看着能显示关联字段（比如 author.name），但搜索框一输就 404 或查不到数据。根本原因是 GridView 的 filter 依赖 ActiveDataProvider 底层的 andFilterWhere()，而它只认 SearchModel 里声明并挂载了关联查询的属性。
正确做法是两步一起动：
- 在
SearchModel::search()中用joinWith(['author'])显式关联，并确保$this->load($params)后调用andFilterWhere(['author.name' => $this->author_name]) - 在
SearchModel类里加 public 属性public $author_name;，不然load()根本不会把 GET 参数塞进来 -
GridView列配置中写'attribute' => 'author_name'，而不是直接写'author.name'—— 后者只适用于纯展示，不参与搜索逻辑
用匿名函数渲染列内容，别 echo，要 return
很多人复制示例时把 value 里的 echo 留着，结果整列空白或报错。Yii2 的 value 回调必须 返回字符串，不是输出。
常见错误写法：function ($model) { echo $model->status == 1 ? '启用' : '禁用'; } → 页面没内容，后台可能报“headers already sent”
正确写法：
function ($model) { return $model->status == 1 ? '启用' : '禁用'; }- 如果要加 HTML，记得设
'format' => 'raw'，否则会被转义 - 涉及多字段拼接（如省市合并）：用
"{$model->province}-{$model->city}"比$model->province . '-' . $model->city更安全，避免空值报 Notice
下拉筛选 filter 传中文值？数据库肯定查不到
'filter' => ['1' => '启用', '0' => '禁用'] 看起来很干净，但用户点“启用”后，GET 参数变成 ?Status=启用，而数据库字段存的是数字 1，必然查无结果。
真正起作用的只有键（key），不是值（value）。所以必须让键和数据库存储值一致：
- 错误：
'filter' => ['启用' => '启用', '禁用' => '禁用'] - 正确：
'filter' => ['1' => '启用', '0' => '禁用']，同时确保andFilterWhere(['status' => $this->status])对应的是数字字段 - 如果状态是字符串（如
'active'/'inactive'），那键就得写成'active' => '启用'
顺带一提：这个下拉选项数组必须在 SearchModel 里定义为方法或常量，硬写在视图里会难以复用和测试。
排序图标不显示、点击无反应？检查 attribute 和 sort 定义
自定义列默认不参与排序，哪怕写了 'attribute' => 'author_name'。因为 Yii 不知道该按哪个物理字段排序 —— 是 author.name 还是 user.profile_name？
解决办法是显式告诉 Sort 规则：
- 在
SearchModel::search()中，给ActiveDataProvider加'sort' => ['defaultOrder' => ['id' => SORT_DESC], 'attributes' => ['author_name' => ['asc' => ['author.name' => SORT_ASC], 'desc' => ['author.name' => SORT_DESC]]]] - 如果只是简单映射单字段，也可以偷懒用
'attributes' => ['author_name' => 'author.name'] - 漏掉这一步，列头虽有排序图标，但点击后 URL 变了（如加了
&sort=-author_name），实际 SQL 却没加ORDER BY
最易忽略的一点：关联字段排序必须确保 joinWith() 已执行，否则 SQL 会报 “Unknown column” —— 这个错误往往被静默吞掉，只表现为排序失效。
