Yii2默认不自动同步关联表外键字段，需显式赋值并save；link()仅建内存关联，不更新已存在记录的外键值；批量更新应优先用原生SQL或事务内统一处理。
更新主表时外键字段没变，但关联表数据需要同步更新
Yii2 默认不会自动同步关联表的外键字段——哪怕你在 ActiveRecord::update() 里传了关联对象或设置了 link()，只要外键列本身（比如 user_id）没在 $attributes 里显式出现，数据库层面的外键值就不会被修改。
常见表现是：调用 $model->link('profile', $profile) 后查数据库，profile.user_id 仍是旧值；或者用 save() 更新主模型，却忘了把 user_id 放进 $model->attributes 或 save($attributes) 的白名单里。
- 确保外键字段可写：检查对应属性是否在
rules()中允许safe，且不在scenarios()的unsafe列表中 - 显式赋值比依赖
link()更可靠：直接写$profile->user_id = $user->id;再$profile->save() - 如果用
link()，必须先保证外键字段已存在且可赋值——link()只设置关联对象引用，不自动写入外键值到数据库
使用 link() 后外键未写入数据库的典型原因
link() 的作用是建立内存中的关联关系，并触发一次 save()（仅当关联对象尚未保存时），但它**不负责更新外键字段本身**。它只在关联对象是新记录、且主表主键已存在时，把外键值填进关联对象的属性里；如果关联对象已存在，link() 不会改它的外键字段，也不会调用 save()。
- 已有
Profile记录，想把它从用户 A 换到用户 B？不能只靠$userB->link('profile', $existingProfile) - 正确做法：手动改
$existingProfile->user_id = $userB->id;，再$existingProfile->save() - 若想封装逻辑，建议重写
afterSave()或在业务层统一处理，而不是依赖link()的副作用
批量更新主表并同步多个关联表外键
一次更新涉及主表 + 多个关联表（如 Order → OrderItem、ShippingAddress），外键需同时变更，但 Yii2 没有内置的“级联外键更新”机制。硬套 link() 或事务内逐个 save() 容易漏字段或破坏一致性。
- 优先用原生 SQL 批量更新外键：例如
UPDATE order_item SET user_id = :new_user_id WHERE order_id IN (...)，比循环 AR 更稳更快 - 若必须用 AR，把所有关联模型加载出来后，统一赋值再批量
save(false)（跳过验证，确保字段写入） - 务必包裹在事务中：
Yii::$app->db->transaction(function ($db) { ... });，否则某个save()失败会导致部分更新成功、状态不一致 - 注意外键约束：MySQL 的
ON UPDATE CASCADE虽能自动同步，但 Yii2 迁移或模型定义里不体现该行为，容易造成维护盲区
关联表外键字段被设为 NOT NULL 但更新时传了 null
这是生产环境高频报错点：Integrity constraint violation: 1048 Column 'user_id' cannot be null。往往发生在前端没传 ID、或代码里误写了 $model->unlink('profile') 后又没处理残留外键。
- 检查
unlink()行为：它只是断开关联，**不会把外键字段置空或删掉关联记录**；如需清空外键，得显式赋null并save() - 数据库字段定义和模型规则要对齐：如果 DB 是
user_id INT NULL，模型里就得允许user_id为null，并在rules()中声明['user_id', 'default', 'value' => null] - 更新前做防御性判断：
if ($newUserId !== null) { $profile->user_id = $newUserId; }，避免意外写入null
外键同步不是“连上了就完事”，关键在谁负责写、什么时候写、写之前有没有校验。Yii2 的关联方法偏重读取和关系建模，写操作仍需开发者明确控制字段生命周期。
