嵌套预加载不是写得越深越好，TP6 默认不校验路径合法性，错一个方法名或少一个 return 就静默失败——查不到数据、不报错、SQL 日志里也看不到关联查询。
with([‘user.profile.avatar’]) 为什么查不出 avatar？
ThinkPHP 的点号语法 with(‘user.profile.avatar’) 是字符串解析式递归调用，它会依次尝试调用 user() → profile() → avatar() 方法。只要其中任意一层：
方法名拼错（比如写了 avator()）、大小写不符（Avatar() vs avatar()）方法体里没 return（常见于复制粘贴后漏掉最后一行）返回的不是 belongsTo/hasOne 等关联对象（比如写了 return $this->where(…)）中间模型未定义该方法（Profile 没 avatar()，但 User 的 profile() 返回了 Profile 实例）
整个链路就中断，且 TP 不抛异常，只当那一层没写 with。验证方式很简单：dd(User::find(1)->profile->avatar) 手动触发，能取到才是真通。
TP6.0–6.0.12 用字符串写嵌套会失败
在 TP6.0 到 6.0.12 版本中，with(‘user.profile.avatar’) 会被解析成单层字符串，等价于只执行 with(‘user’)；真正生效的必须是数组语法：with([‘user.profile.avatar’])。但注意这个写法在 TP6.1+ 已被标记为“兼容保留”，官方推荐改用嵌套数组形式：
立即学习“PHP免费学习笔记（深入）”；
with([‘user’ => [‘profile’ => [‘avatar’]]])
好处是可为每一层加闭包条件，比如只加载启用的头像：[‘avatar’ => function ($q) { $q->where(‘status’, 1); }]。混用点号和数组（如 with([‘user.profile’ => [‘avatar’]])）会导致 Array to string conversion 错误。
关联方法里写 with() 是埋雷行为
如果 User::with(‘profile’) 能查出数据，但 profile 表字段全出来了，大概率是 Profile 模型的 avatar() 方法里硬编码了 ->with(‘xxx’)。这种写法会让预加载失控：你只想要一级，它自动拉三级；你加了 field()，它内部又把整张表拖回来。
正确做法是把所有 with()、field()、limit() 全部从关联方法体里删掉，只留干净的关联定义：
public function avatar(){ return $this->hasOne(Avatar::class, ‘id’, ‘avatar_id’);}
然后在调用侧显式控制：with([‘profile’ => function ($q) { $q->field(‘id,address’)->with([‘avatar’ => function ($qq) { $qq->field(‘id,status’); }]); }])。
loadRelation() 比 with() 更适合深度可控场景
当你明确只要「用户 + 部门」，且部门绝对不能带公司、公司不能带集团，loadRelation(‘department’) 比 with(‘department’) 更可靠。它不做任何路径解析，只字面匹配 department() 方法，也不递归下钻。
如果真要两级，必须分两次写：->loadRelation(‘department’)->loadRelation(‘department.company’)。混用 with(‘department.company’) 和 loadRelation(‘department’) 会导致后者被覆盖，甚至引发未定义行为。
深层嵌套最易被忽略的是内存和事务风险：一次 with([‘user.orders.items.product’]) 查 100 条用户，可能生成上千个对象，PHP 内存瞬间飙高；更危险的是，后续不小心调了 $user->orders[0]->items[0]->product->name = ‘x’ 再 save()，会意外更新 product 表——而你以为只是读操作。
评论(0)