Yii多表关联需按效果选方式：WHERE或ORDER BY引用关联字段时必须用joinWith()而非with()；复杂连接用join()；hasOne/hasMany参数键值方向易错；关联结果默认缓存，需手动刷新保证一致性。
Yii 里做多表关联查询，不是“该用哪个方法”，而是“你想要什么效果”——要懒加载、预加载、还是原生 JOIN？选错方式，轻则 N+1 查询拖垮接口，重则数据错乱、字段覆盖。
什么时候必须用 joinWith() 而不是 with()
当你要在 WHERE 或 ORDER BY 中引用关联表字段时，with() 会失效。它只做额外的独立查询，不改主 SQL 的 FROM 和 JOIN 子句。
-
with('author')→ 发起两条 SQL：SELECT * FROM book+SELECT * FROM author WHERE id IN (1,2,3) -
joinWith('author')→ 合并在一条 SQL：SELECT book.*, author.name FROM book LEFT JOIN author ON book.author_id = author.id - 想查“所有作者名包含‘鲁迅’的图书”？必须用
joinWith('author')->where(['like', 'author.name', '鲁迅'])，with()做不到 -
joinWith()默认是LEFT JOIN，如果只想取有作者的图书，得显式写joinWith('author', true, 'INNER JOIN')
join() 手写 SQL 连接的适用场景
当关联模型没定义好、或要连非标准外键（比如用字符串匹配、时间范围 join）、或要连视图/临时表时，join() 是唯一选择。
-
join('LEFT JOIN', 'user_profile', 'user.id = user_profile.uid')—— 表名和条件都自己控，不依赖模型关系 - 别漏掉表别名：如果主表是
User::find()，又join('user_log', 'user.id = user_log.user_id')，而user_log也有id字段，select('*')会字段冲突，必须用select('user.*', 'user_log.action') -
join()不会自动处理关联缓存，也不触发模型事件，纯 SQL 层操作 - 调试时用
createCommand()->getRawSql()看生成的 SQL，避免手写条件拼错空格或引号
hasOne() 和 hasMany() 的参数容易写反
第二个参数数组里的「键值方向」是高频翻车点：键是**关联模型的字段**，值是**当前模型的字段**。
- 正确写法（Order 找 Customer）：
return $this->hasOne(Customer::className(), ['id' => 'customer_id']);→ Customer 表的id匹配 Order 表的customer_id - 写反了（
['customer_id' => 'id']）会导致 SQL 条件变成WHERE customer.customer_id = order.id，查出来全是空 - 一对多同理：
Customer::getOrders()应该是['customer_id' => 'id']，表示 Order 表的customer_id指向 Customer 表的id - 字段名带表前缀？别加。Yii 会在生成 SQL 时自动加别名，手动写
'customer.id'会报错或被忽略
关联结果不更新？先看是不是缓存惹的祸
用属性方式访问关联（如 $order->customer）时，Yii 默认缓存结果。改库后不生效，不是代码问题，是机制使然。
- 首次访问
$order->customer→ 查库并存到$order->_related['customer'] - 再次访问 → 直接返回缓存对象，不再查库
- 强制刷新：用
unset($order->customer)再读，或改用方法调用$order->getCustomer()->one() - 批量操作中尤其危险：循环里反复读
$item->user，但中间某次更新了 user 表，后续 item 都拿不到新数据 - 如果业务要求强一致性，别依赖懒加载，统一用
joinWith()或显式refresh()
关联字段名、连接类型、缓存行为这三块，错一个就查不到数据或性能崩掉。别背 API，打开日志看实际执行的 SQL，比读文档管用十倍。
