Laravel中间件抛出的UnprocessableEntityException在web路由不生效怎么办？

问题原因 #

Laravel默认会根据请求所属路由组（api/web）返回不同格式的异常响应：api路由组下自动返回JSON格式，web路由组则默认渲染错误视图。你的异常处理器在api路由正常工作，但web路由下会走默认的视图渲染逻辑，导致无法按预期返回异常数据。

解决方案 #

1. 调整全局异常处理器的响应逻辑 #

在app/Exceptions/Handler.php的render方法中，针对UnprocessableEntityException强制统一返回JSON响应（或你需要的格式），不受路由组影响：

public function render($request, Throwable $exception)
{
    if ($exception instanceof UnprocessableEntityException) {
        return response()->json([
            'message' => $exception->getMessage(),
            'errors' => method_exists($exception, 'getErrors') ? $exception->getErrors() : []
        ], 422);
    }

    return parent::render($request, $exception);
}

这样不管是api还是web路由，抛出该异常时都会返回JSON格式的响应，无需在视图中处理展示。

2. 在中间件内部捕获异常并返回响应 #

既然异常是在中间件中抛出的，可直接在中间件的handle方法里捕获该异常，直接返回目标格式的响应，跳过全局异常处理器的路由判断逻辑：

public function handle($request, Closure $next)
{
    try {
        // 中间件业务逻辑
        return $next($request);
    } catch (UnprocessableEntityException $e) {
        return response()->json([
            'message' => $e->getMessage(),
            'errors' => $e->getErrors() // 假设你的异常类提供该方法获取错误详情
        ], 422);
    }
}

3. 无需转换所有抛出数据 #

你不需要转换所有异常的返回数据，只需针对UnprocessableEntityException单独处理响应格式即可。上述两种方案都能让web路由下的该异常按你需要的方式返回数据，不用修改其他异常的处理逻辑。

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