Laravel 11中Query Builder调用firstOrFail()报错与文档不符问题

• 核心问题：DB::table()返回的是基础查询构建器（Illuminate\Database\Query\Builder），这个类本身没有firstOrFail()方法；文档里提到的firstOrFail()是Eloquent查询构建器（Illuminate\Database\Eloquent\Builder）的方法，只有通过Eloquent模型发起查询时才会用到这个类。

• 两种解决方式：

  1. 如果你已经有对应的Eloquent模型（比如Region模型），直接用模型查询：

     $usa_region = Region::where('slug', 'usa')->firstOrFail();
     

  2. 要是不想用Eloquent模型，用基础查询构建器的替代写法手动处理：

     $usa_region = DB::table(self::REGIONS_TABLE)->where('slug', 'usa')->first();
     if (!$usa_region) {
         abort(404); // 也可以抛出你需要的自定义异常
     }
     

• 文档说明的误区：官方文档的“查询构建器”章节会把基础查询构建器和Eloquent查询构建器的方法放在一起展示，容易让人混淆。要明确两者的区别：基础查询构建器是直接操作数据库表的底层工具，而Eloquent构建器是基于模型的封装，提供了更多面向业务模型的便捷方法。

内容的提问来源于stack exchange，提问作者Drew Gallagher