laravel的findOrFail和firstOrFail怎么用_laravel findOrFail与firstOrFail使用方法_网络技术

发布时间 - 2025-10-23 00:00:00 点击率：次

findOrFail 方法通过主键查找记录，若未找到则抛出 404 异常，适用于单条或批量主键查询；firstOrFail 在查询构造器链式调用后获取首条记录，若无结果则同样抛出异常，常用于唯一条件匹配场景。

如果您在使用 Laravel 查询数据库时需要确保记录存在，否则抛出异常，则可以使用 findOrFail 或 firstOrFail 方法。这些方法能有效简化错误处理流程。

本文运行环境：MacBook Pro，macOS Sonoma

一、findOrFail 的使用方法

findOrFail 方法用于根据主键查找单条记录，如果找不到对应的模型实例，则自动抛出一个 Illuminate\Database\Eloquent\ModelNotFoundException 异常。

1、调用模型的 findOrFail 方法并传入主键值，例如查询 ID 为 5 的用户记录：User::findOrFail(5)。

2、在控制器中直接使用该方法，框架会自动拦截 ModelNotFoundException 并返回 404 响应页面，无需手动检查是否存在。

3、可传入多个主键 ID 组成的数组来获取多个模型实例，若任一 ID 不存在，则抛出异常。

firstOrFail 方法适用于通过查询构造器链式调用后获取第一条记录，若结果为空则抛出 ModelNotFoundException 异常。

1、在构建了查询条件之后调用 firstOrFail，例如查询状态为激活且邮箱等于特定值的用户：User::where('status', 'active')->where('email', 'test@example.com')->firstOrFail()。

2、此方法常用于精确匹配某条数据的场景，如验证唯一字段的存在性。

3、与 get 方法不同，firstOrFail 只返回单个模型实例或异常，不会返回集合。