Yii关联需双向契约：foreignKey指从模型外键字段，inverseOf指从模型反查方法名；hasOne返回null属正常；嵌套with易出错；关联修改需手动save，非自动同步。
关联定义写错，foreignKey 和 inverseOf 容易颠倒
Yii 的 hasMany 和 hasOne 不是单向声明，而是双向契约。你写在主模型里的 foreignKey 必须对应从模型的字段名（通常是外键字段），而 inverseOf 必须指向从模型里定义的、返回当前模型的关联方法名——不是字段名，也不是任意字符串。
常见错误现象：Undefined index: id 或关联结果始终为空，但 SQL 查出来明明有数据；或者 eager loading 时触发 N+1 查询却没报错。
-
foreignKey是「我（主模型）靠哪个字段去查对方」：比如User::hasMany(Order::class, ['user_id' => 'id'])中，user_id是Order表的字段，id是User表的主键 -
inverseOf是「对方（从模型）用哪个方法能反查回来」：必须和从模型中定义的方法名完全一致，比如Order里写了getCustomer()，那User里就得写->inverseOf('customer') - 如果从模型没定义反向关联，就别写
inverseOf；写了却对不上，ActiveRecord 就不会自动优化查询或设置反向引用
hasOne 返回 null 却不报错，但实际数据存在
这通常不是 bug，而是 Yii 默认行为：当关联记录不存在时，hasOne 返回 null，而不是抛异常。但开发者常误以为“查不到 = 没配好”，其实更可能是条件过滤过严或数据不匹配。
使用场景：查用户头像（Avatar）、配置项（UserSetting）这类可选一对一关系。
- 检查外键值是否为
NULL或 0：比如user_id在avatar表里是NULL，hasOne就一定返回null - 留意类型隐式转换：MySQL 中
user_id是INT，但 PHP 传了字符串'1'，某些 Yii 版本（尤其老版本）可能不自动 cast，导致 JOIN 失败 - 用
with()+asArray()调试：看生成的 SQL 是否包含 LEFT JOIN，以及 ON 条件是否符合预期
Eager loading 时 hasMany 嵌套层级一深就出错
比如 User::find()->with(['orders.items.product'])->all()，看似合理，但 Yii 2.x 对多层嵌套的 via 或 viaTable 支持有限，容易触发 Trying to get property of non-object 或空数组。
性能影响明显：没写好 via 会导致生成多个子查询，甚至笛卡尔积。
- 确认中间关联是否用了
via()或viaTable()：比如Order::hasMany(Item::class, ['order_id' => 'id'])->via('items')，那items方法本身必须返回有效的hasMany - 避免在
via关联里再嵌套via：Yii 2.0.x 不支持三层via链，会静默失败；升级到 2.0.44+ 或改用手动 JOIN - 调试技巧：在
with()后加->createCommand()->getRawSql()，直接看 SQL 是否符合你的 JOIN 意图
关联查询后修改主模型，从模型数据没同步更新
这是 Active Record 的惰性加载特性带来的认知偏差：关联对象是独立实例，哪怕你调用 $user->orders[0]->status = 'shipped'，也不会自动保存，更不会触发主模型的 dirty 检测。
容易踩的坑：以为赋值完就完了，结果数据库毫无变化；或者在事务里漏掉 save() 导致部分数据落库失败。
- 每个从模型实例都得单独
save()：不能只调$user->save()就指望级联更新 - 批量操作优先用 DAO 或原生 SQL：比如更新所有订单状态，
Order::updateAll(['status' => 'done'], ['user_id' => $user->id])比循环save()快得多且原子 - 想自动级联，得自己实现
afterSave()或监听事件；Yii 自带的cascade只作用于数据库外键约束，不触发 PHP 层逻辑
关联不是魔法，它只是帮你组织查询和对象关系。真正难的从来不是怎么写 hasMany，而是想清楚：这个关联要不要懒加载、要不要缓存、改了之后谁负责持久化、并发时会不会读到脏数据。
