预加载必须在查询执行前通过with()声明，否则触发N+1；正确写法是User::with('posts')->get()，错误写法如User::all()->with('posts')会报错；嵌套需用点号数组如['user.avatar']，带条件须用闭包，大数据量应chunkById()分批。
预加载不是“查完再补”，而是必须在查询执行前声明；with() 放错位置、传参格式不对、嵌套写法错误，都会让 N+1 问题原封不动回来。
with() 必须在 get() / first() / paginate() 之前调用
常见错误是先执行查询，再链式加 with()：比如 User::all()->with('posts') 或 Post::get()->with('user')。这会直接报错 Call to undefined method Illuminate\Database\Eloquent\Collection::with()，因为 all() 和 get() 返回的是 Collection 实例，不是查询构建器。
- ✅ 正确：
User::with('posts')->get()、Post::with('user')->first()、User::with('profile')->paginate(15) - ❌ 错误：
User::all()->with('posts')、Post::get()->with('user')、User::find(1)->with('posts')（find()已执行查询） - ⚠️ 注意：
load()是给已有模型补关联的，比如$users = User::get(); $users->load('posts')，但它仍是 N 条 SQL，不解决 N+1，只把懒加载“集中延迟”
嵌套预加载必须用点号 + 数组，不能链式 or 多字符串
想加载 Post → user → avatar，不能写成两次 with()，也不能传多个字符串参数。Laravel 不支持叠加，后一次会覆盖前一次，或直接 PHP 报错 Too many arguments。
- ✅ 正确：
Post::with(['user.avatar'])->get()、StoreStock::with(['product.price', 'product.masterlist'])->get() - ❌ 错误：
Post::with('user')->with('user.avatar')->get()（只生效user.avatar）、Post::with('user.avatar', 'user.role')->get()（PHP 参数错误） - ⚠️ 验证方式：启用
DB::enableQueryLog()后执行，确认 SQL 条数是否稳定在「主表 + 每个独立关系一层」，比如 3 层嵌套仍只多 2 条查询（users、avatars），而不是翻倍
带条件的预加载必须用闭包，且必须作为数组元素值
where() 直接跟在 with() 后面是无效的——它只会作用于主模型查询，不会下推到关联子查询里。Eloquent 的预加载子查询是隔离执行的，必须显式通过闭包注入约束逻辑。
- ✅ 正确：
Post::with(['comments' => function ($q) { $q->where('status', 'approved')->latest()->limit(1); }])->get() - ❌ 错误：
Post::with('comments')->where('status', 'approved')->get()（查的是posts表）、Post::with(['comments' => $q->where(...)])（语法错误） - ⚠️ 关键限制：
limit()在预加载中不保证生效（Eloquent 可能忽略），尤其当你要“每个用户只取最新 3 篇文章”时，with(['posts' => fn($q) => $q->limit(3)])是靠不住的，得换子查询或分步处理
大数据量时别硬扛，用 chunkById() + with() 分批
一次性 with() 几万条记录，很容易触发 Allowed memory size exhausted。这不是配置调大就能解决的问题，而是数据结构本身撑爆了 PHP 内存。
- ✅ 推荐：
User::with('profile', 'posts')->chunkById(500, function ($users) { foreach ($users as $user) { /* 处理 */ } }); - ❌ 避免：
User::with('profile', 'posts')->get()（全量加载）、User::chunk(500, ...)（没with()，N+1 回来） - ⚠️ 注意：
cursorPaginate()不支持with()，所以分页场景若需预加载，优先选paginate()；如果数据量极大又必须游标分页，就得手动用DB::table()+ 子查询替代
最常被忽略的一点：预加载是否生效，光看代码写法不够，一定要用 DB::getQueryLog() 或 Laravel Telescope 看真实 SQL —— 很多时候你以为加载了 user.avatar，结果日志里只有 users 和 users，根本没发第二条查询，原因往往是模型里 avatar() 方法返回类型写错了，或者漏了 return。
