ThinkPHP 的 save() 无法更新关联表数据，因其仅作用于当前模型表；关联字段需显式操作关联模型实例，如用 findOrEmpty() 判空后保存，或批量时用 Db::table() 避免 N+1。
不能直接用主模型的 save() 更新从属表数据，这是 ThinkPHP 的设计限制，不是你写错了。
为什么 save() 对关联字段完全无效
ThinkPHP 的 save() 只作用于当前模型对应的数据表，不会自动穿透到关联模型。比如：
$user->profile->avatar = 'x.jpg'; $user->save(); —— 这行不通，$user->save() 只会更新 user 表，profile 表毫无反应。
更危险的是空关联：$user->profile 返回 null 时，$user->profile->save() 直接抛出 Call to a member function save() on null。
立即学习“PHP免费学习笔记（深入）”；
allowField() 也不认点号字段（如 profile.avatar），传进去会被忽略；update() 实例方法同样不支持这种写法，静默失败或报错。
- 关联字段必须显式操作关联模型实例，不能靠主模型“带过去”
- 想用
whereHas()做条件更新（如“更新所有有认证资料的用户状态”），模型静态update()不支持，会只改主表或报错 - 时间戳、软删除、验证规则等模型层逻辑，也不会自动应用到关联模型上
一对一关联：先查再存，别绕开判空
最稳的做法是显式获取关联记录，确保它存在，再更新：
$profile = $user->profile()->findOrEmpty();
如果为空，就创建一条：
if (!$profile) { $profile = Profile::create(['user_id' => $user->id]); }
然后赋值并保存：
$profile->autoWriteTimestamp(false)->avatar = 'x.jpg'; $profile->save();
- 用
findOrEmpty()而不是find()，避免null导致后续调用失败 - 手动关掉时间戳（
autoWriteTimestamp(false)）可防止意外覆盖update_time - 批量更新多个用户的 profile 时，绝不要循环
save()，改用Db::table('profile')->whereIn('user_id', $ids)->update([])，避开 N+1 和锁表风险
一对多关联：用 together 但前提很苛刻
together 看似省事，但必须同时满足：
① 关联定义里明确开启 'autoWrite' => true；
② 数据结构严格匹配：从表模型必须有正确主键（$pk），且传入数组中每项若含 id 才算更新，不含则新增；
③ 要删旧项，不是传 ['id'=>123, 'deleted'=>1]，而是“完全不出现这条记录”。
示例写法：
$order->items = $newItemsData; $order->save(['together' => ['items']]);
-
$newItemsData里混了user_id但模型主键是id？那会被当成新插入，触发主键冲突 - 从表启用了软删除，
together不会自动过滤已删除项，得提前where('delete_time', null)或手动清理 -
together是单次行为，不级联、不递归，下一层关联（如订单项里的商品）不会被处理
多对多关联：别乱用 sync()，中间表字段必须对齐
sync() 是清空再重插，适合“最终状态”场景（如角色权限必须精确等于 [2,5,7]）；attach()/detach() 是增量操作，但不保证事务安全。
常见崩点：
中间表名写成 user_role 而非框架约定的 role_user（字母序小写下划线），sync() 会静默写入 0；
外键字段名不是 user_id / role_id，而是 uid / rid，就必须在 belongsToMany() 中显式传第 5/6 个参数；
中间表有额外字段（如 is_primary），不调 withPivot(['is_primary'])，读出来就是空的；
要写额外字段或加业务校验，必须建 Pivot 模型并继承 think\model\Pivot，普通 Model 不行。
复杂更新别裸奔：sync() 不触发模型事件，attach() 并发时可能因唯一索引报错，务必包 Db::transaction()。
真正难的从来不是语法——是并发下关联记录被删、主表成功但从表失败、软删除状态没同步这些边界问题。模型方法不兜底，得自己加判空、捕获异常、必要时手动回滚。
