Laravel路由使用User模型时，如何自定义用户不存在的响应？

你当前用的是隐式路由模型绑定，Laravel会自动查找对应ID的User模型，找不到就抛出ModelNotFoundException并默认返回404。要自定义这个响应，有三种常用实现方式：

方法一：手动查询控制（简单直接） #

把隐式绑定改成普通参数，手动查询用户后判断是否存在，完全自定义返回内容：

// 修改路由，将{user}改为普通参数{userId}
Route::post('/users/validate-pin/{userId}', [\App\Http\Controllers\Api\UserController::class, 'validatePIN'])->name('api-users.validatePIN');

更新控制器方法：

public function validatePIN($userId, Request $request)
{
    try {
        if(!$request->user()->can('Validar PIN')){
            return response()->json([
                'success' => false,
                'message' => 'Não autorizado',
                'error' => 'Unauthenticated',
            ], 401);
        }

        // 手动查询用户，不存在则返回自定义响应
        $user = \App\Models\User::find($userId);
        if (!$user) {
            return response()->json([
                'success' => false,
                'message' => 'Usuário não encontrado',
                'error' => 'User not found'
            ], 404);
        }

        // 后续业务逻辑...

    } catch (\Throwable $error) {
        return response()->json([
            'success' => false,
            'message' => 'Erro no sistema',
            'error' => $error->getMessage(),
        ], 500);
    }
}

方法二：全局捕获异常（统一所有API场景） #

如果想让所有API路由的模型绑定404都用同一套自定义响应，修改app/Exceptions/Handler.php的register方法：

use Illuminate\Database\Eloquent\ModelNotFoundException;

public function register()
{
    $this->renderable(function (ModelNotFoundException $e, $request) {
        // 仅对API路由返回自定义JSON
        if ($request->is('api/*')) {
            return response()->json([
                'success' => false,
                'message' => 'Recurso não encontrado',
                'error' => $e->getMessage()
            ], 404);
        }
    });
}

这样所有API下的模型绑定找不到时，都会返回你定义的JSON格式，不用逐个控制器修改。

方法三：自定义单模型绑定逻辑 #

在RouteServiceProvider的boot方法里，给User模型单独设置绑定规则：

use App\Models\User;
use Illuminate\Database\Eloquent\ModelNotFoundException;

public function boot()
{
    parent::boot();

    Route::bind('user', function ($value) {
        $user = User::find($value);
        if (!$user) {
            // 抛出异常后配合全局捕获返回自定义响应，保持逻辑统一
            throw new ModelNotFoundException();
            // 也可以直接返回响应，但全局处理更推荐
            // return response()->json([...], 404);
        }
        return $user;
    });
}

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