first() 返回 null，适合可选查询；findOrFail() 抛出异常，适合必须存在的主键查找；firstWhere() 对 null 值需用 whereNull() 避免 SQL 错误；API 应明确返回 404 或空数组以区分语义。
查不到数据时 first() 和 findOrFail() 的区别
很多人以为 first() 返回 null 就够用了，但实际业务里常需要区分“没查到”和“查到了但字段为空”。first() 在无结果时返回 null，安全但不够主动；findOrFail() 则直接抛出 ModelNotFoundException，适合必须存在、缺了就该报错的场景（比如用户详情页查 User::findOrFail($id)）。
容易踩的坑：在 API 接口里盲目用 findOrFail()，没配全局异常处理器，结果返回 500 而不是 404；或者在表单提交后查关联记录时用 first() 却忘了判空，后续调用 $post->title 报 Call to a member function on null。
-
first()：适合可选查询，后续必须加if ($model) { ... } -
findOrFail($id)：适合主键精确查找，且业务逻辑上该记录理应存在 - 想统一处理 404，建议在
app/Exceptions/Handler.php中捕获ModelNotFoundException并返回 JSON 404 响应
Laravel 11+ 的 firstWhere() 和空值陷阱
firstWhere() 看似方便，但参数顺序和类型容易翻车。它接受三个参数：firstWhere($column, $operator, $value) 或简写 firstWhere($column, $value)（此时默认 operator 是 ==）。问题在于：如果 $value 是 null 或空字符串，且数据库字段允许 NULL，那 firstWhere('status', null) 实际生成的 SQL 是 WHERE status = NULL —— 这永远不成立，得用 IS NULL。
正确做法是显式用 whereNull()：
Post::whereNull('published_at')->first();
或者用 where() 配合 DB::raw()（不推荐）。
- 别对 NULL 值用
firstWhere('col', null)，改用whereNull('col')->first() - 字符串比较注意 trim：用户输入的 ' '（空格）不会匹配数据库里的 ''（空字符串）
-
firstWhere()不会触发模型的boot()或访问器，查出来的数据是原始值
API 接口里返回空结果的标准姿势
前端要的是明确语义，不是 PHP 的 null 或空数组。直接 return response()->json(['data' => null]) 很模糊 —— 是查失败？还是查成功但没数据？更糟的是有些团队还塞个 'message' => 'success'，让前端更懵。
推荐分层处理：查不到就明确返回 404 + 标准结构；查到空集合（如搜索无结果）则用 200 + 'data' => [] + 可选 'meta' => ['total' => 0]。
- 单条记录不存在：
return response()->json(['message' => 'Not found'], 404) - 列表查询无结果：
return response()->json(['data' => [], 'meta' => ['total' => 0]]) - 避免在控制器里写
if (!$user) { return [...]; }，抽成abort_if(!$user, 404)更清晰
Eloquent 关系查询中空结果的连带影响
查 $user->posts 返回空集合（Collection），不是 null，所以 if ($user->posts) 恒为 true；但 $user->posts->first() 是 null。这种差异导致模板里 @foreach($user->posts as $post) 安全，而 {{ $user->posts->count() }} 也安全，但 {{ $user->posts->first()->title }} 会炸。
关系方法名本身不触发查询，只有访问或调用 get()/first() 才查。所以 $user->posts 是懒加载对象，$user->posts()->first() 才是真正执行一次查询。
- 遍历前别假设关系一定有数据，用
$user->posts->isNotEmpty()判空比count() > 0稍高效 - 想提前知道有没有关联记录，用
whereDoesntHave('posts')比查出来再isEmpty()更省资源 - 在
with()预加载时，空关系不会报错，但要注意 N+1 问题是否真的被解决
空结果本身不难处理，难的是在模型层、查询构造器层、HTTP 响应层之间保持语义一致。最常被忽略的，是把「数据库没这条记录」和「这条记录存在但某个字段为空」混为一谈 —— 它们对应完全不同的业务含义，代码里得用不同分支来表达。
