with()必须传模型中定义的关联方法名而非表名，大小写需完全一致；预加载不保证关联存在，需判空；whereHas()用于数据库层过滤，与with()语义不同。
with() 必须传关联方法名，不是表名
很多人写 with('profiles') 或 with('user_profile')，结果预加载失效，原因很简单：Eloquent 只认你在模型里定义的关联方法名。比如 User 模型中写了 public function profile()，那就只能用 with('profile')；如果写成 public function userProfile()，就必须用 with('userProfile') —— 驼峰命名不用转下划线，大小写必须完全一致。
常见错误现象：dd($user->profile) 有数据，但 with('profiles') 后 $user->profile 仍是 null，说明预加载根本没命中方法。
- 检查模型中关联方法是否 public、是否返回
$this->hasOne(...) - 确认方法名和
with()参数字符串完全一致（包括大小写） - 不要依赖表名、数据库字段名或变量命名习惯去猜方法名
预加载后访问空关联仍会报错？得主动判空
with('profile') 能保证关联数据被查出来，但不等于每个用户都有 profile。如果数据库里某条 users.id = 5 没对应 profiles.user_id = 5 的记录，$user->profile 就是 null。直接调 $user->profile->name 会抛出 Call to a member function name() on null。
正确做法是在视图或业务逻辑里先判断：
@if($user->profile)
{{ $user->profile->name }}
@else
——
@endif
- 别依赖
with()自动“兜底”，它只负责查，不负责补默认值 - 想统一处理空关联，可在模型里加访问器，比如
getProfileNameAttribute()，内部做空判断 - 如果业务上“必须有 profile”，应在数据库加外键约束 + 迁移时设
nullable(false)
whereHas() 和 with() 别混用当过滤条件
有人以为 User::with('profile')->get() 再在循环里 if ($user->profile) 就能筛出有资料的用户——这是错的。这仍然查了全部用户，只是 PHP 层过滤，浪费 I/O 和内存。真正要“只取有 profile 的用户”，必须用 whereHas('profile')。
两者 SQL 行为完全不同：
-
with('profile')→ 主查users，再额外发一条SELECT * FROM profiles WHERE user_id IN (...) -
whereHas('profile')→ 主查带EXISTS (SELECT 1 FROM profiles WHERE profiles.user_id = users.id)子查询，不查 profiles 表数据 - 需要“有 profile 且带上 profile 数据”？组合用：
User::with('profile')->whereHas('profile')->get()
闭包预加载能加条件，但别滥用
给 with() 传闭包可以限制关联数据范围，比如只查启用的 profile：with(['profile' => function ($q) { $q->where('status', 1); }])。这很实用，但要注意：
- 闭包里的
select()必须包含外键字段（如user_id），否则 Eloquent 关联映射失败 - 如果主模型用了
take(10)，闭包查询仍会按条件查所有匹配的关联记录，不是“每个用户只取 1 条” - 复杂条件建议拆到关联方法里定义作用域（
scopeActive()），保持控制器干净
最易忽略的一点：预加载闭包不会影响主查询结果数量，它只改关联数据内容。如果 profile 表里某用户有两条 status=1 的记录，而你定义的是一对一关系，Eloquent 仍只取第一条——这个行为由底层 SQL 的 IN 或 JOIN 方式决定，不报错也不提醒。
