Laravel API如何自定义记录未找到时的默认错误响应消息

问题原因 #

你遇到的返回结果带模型路径的问题，是Laravel隐式模型绑定的默认机制导致的：当路由参数对应的模型记录不存在时，Laravel会在请求进入控制器方法之前直接抛出ModelNotFoundException，最终转换为你看到的404响应，根本不会走到你控制器中写的if/else判断逻辑。

可落地的实现方案 #

方案1：放弃隐式绑定，手动查询（最简修改，单接口适配） #

直接修改控制器方法，不使用注入的模型实例，改为接收ID手动查询：

// 控制器代码修改后
public function show($mrl)
{
    $data = \App\Seasonal\Mrl::find($mrl);
    if ($data) {
        return response(['status' => 'ok', 'data' => $data], 200);
    } else {
        // 建议返回404状态码更符合HTTP语义，不需要返回500
        return response(['status' => 'error', 'message' => '请求的资源不存在'], 404);
    }
}

这个方案不需要修改其他全局配置，仅针对当前接口生效。

方案2：全局异常捕获（推荐API项目使用，统一所有接口规范） #

修改app/Exceptions/Handler.php的register方法，全局捕获模型不存在的异常，统一返回自定义格式：

public function register()
{
    $this->renderable(function (\Illuminate\Database\Eloquent\ModelNotFoundException $e, $request) {
        // 仅对API请求生效，不影响Web端原有404页面逻辑
        if ($request->expectsJson()) {
            return response()->json([
                'status' => 'error',
                'message' => '请求的资源不存在'
            ], 404);
        }
    });
}

这个方案不用修改任何控制器/路由代码，所有模型的隐式绑定找不到记录时都会返回统一的自定义响应，适合API项目做全局规范。

方案3：自定义单个模型的绑定逻辑（仅针对Mrl模型生效） #

如果只需要修改Mrl模型的绑定返回结果，其他模型保留默认逻辑，可以在Mrl模型中重写resolveRouteBinding方法：

// 写在Mrl模型类中
public function resolveRouteBinding($value, $field = null)
{
    $model = parent::resolveRouteBinding($value, $field);
    if (!$model && request()->expectsJson()) {
        abort(response()->json([
            'status' => 'error',
            'message' => '请求的MRL资源不存在'
        ], 404));
    }
    return $model;
}

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