Laravel查询无匹配记录时返回错误信息的最优方式咨询

我明白你在Laravel里用Query Builder查询时遇到的困境——当没有匹配记录时，想优雅地返回错误信息但试了几种方法都没达到预期。咱们一步步来拆解最优的实现方式，顺便说说为什么你之前的尝试可能没生效。

先纠正你代码里的一个小问题 #

你之前的代码中，$item是验证后的数组（比如['item' => '传入的值']），直接把它传给where的话，相当于用整个数组去匹配ITEMID，这大概率是导致你之前各种方法失效的核心原因！要改成取数组里的item字段值。

方案1：控制器内直接判断集合（最直观，适合多条记录场景） #

get()方法返回的是一个Collection集合，我们可以用isEmpty()方法判断是否有匹配记录，然后返回带错误提示的响应：

public function store() {
    $validated = request()->validate([
        'item' => 'required|min:6|max:10'
    ]);
    
    // 注意这里要取验证后的item字段值
    $details = DB::connection('sqlsrv')
        ->table('TABLENAME')
        ->where('ITEMID', '=', $validated['item'])
        ->get();
    
    // 判断集合是否为空
    if ($details->isEmpty()) {
        // 推荐：重定向回表单，保留用户输入并显示错误
        return back()
            ->withErrors(['item' => '没有找到匹配的记录'])
            ->withInput();
        
        // 如果你想直接返回原视图，也可以传递错误变量
        // return view('itemdetails.create', [
        //     'details' => $details,
        //     'error' => '没有找到匹配的记录'
        // ]);
    }
    
    return view('itemdetails.create', compact('details'));
}

对应的Blade模板处理（如果用重定向的withErrors）：

<!-- 在表单上方显示错误 -->
@error('item')
    <div class="alert alert-danger">
        {{ $message }}
    </div>
@enderror

<!-- 渲染查询结果 -->
@foreach($details as $detail)
    <!-- 你的结果展示代码 -->
@endforeach

方案2：使用firstOrFail()（适合单条记录场景） #

如果你只需要查询单条记录，Query Builder也支持firstOrFail()方法——当没有匹配记录时，它会自动抛出ModelNotFoundException，我们可以通过try-catch捕获并返回提示：

public function store() {
    $validated = request()->validate([
        'item' => 'required|min:6|max:10'
    ]);
    
    try {
        $detail = DB::connection('sqlsrv')
            ->table('TABLENAME')
            ->where('ITEMID', '=', $validated['item'])
            ->firstOrFail();
            
        return view('itemdetails.create', compact('detail'));
    } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $e) {
        return back()
            ->withErrors(['item' => '没有找到匹配的记录'])
            ->withInput();
    }
}

方案3：全局异常处理（适合统一所有未找到场景） #

如果你的项目中有很多类似的“未找到记录”场景，可以在全局异常处理器中统一捕获ModelNotFoundException，避免重复写try-catch：

打开app/Exceptions/Handler.php，修改register方法：

use Illuminate\Database\Eloquent\ModelNotFoundException;

public function register()
{
    $this->renderable(function (ModelNotFoundException $e, $request) {
        // 可以指定只处理特定路由的请求
        if ($request->is('items/*')) {
            return back()
                ->withErrors(['message' => '没有找到匹配的记录'])
                ->withInput();
        }
    });
}

最优方案推荐 #

• 如果是查询多条记录：优先用方案1的isEmpty()判断，配合重定向+flash错误消息的方式，能保留用户输入，体验更好。
• 如果是查询单条记录：优先用方案2的firstOrFail()，代码更简洁，符合Laravel的设计思想。

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