Laravel 7 API异常处理疑问：中间件无法捕获异常及语法错误处理

问题1：为何异常在控制器中能被处理，但中间件却不行？ #

• 全局异常处理器优先级更高：Laravel的app/Exceptions/Handler.php是全局异常捕获入口，所有未被手动捕获的异常都会先被它接管。你的中间件try/catch只能捕获中间件自身或后续流程中未被其他catch捕获的异常，像除零错误这类未被控制器手动捕获的异常，会直接流到全局Handler，中间件的catch根本拿不到。
• 致命错误触发时机过早：语法错误、编译错误这类致命错误，会在Laravel请求生命周期早期触发（比如路由文件、控制器文件加载阶段），此时中间件还未开始执行，自然无法被中间件捕获。
• 控制器try/catch是局部捕获：控制器里的try/catch直接包裹了错误触发的代码，异常会被当场捕获，不会流到外层的中间件或全局Handler。

问题2：如何处理语法错误及所有可能的异常、错误，返回HTTP 500响应？ #

正确的做法是修改全局异常处理器app/Exceptions/Handler.php，它是Laravel处理所有异常、错误的核心入口，能覆盖所有场景：

步骤1：处理API请求的普通异常 #

在render方法中判断请求是否属于API范畴，返回统一的500 JSON响应：

public function render($request, Exception $exception)
{
    // 根据实际API路由规则调整判断逻辑，比如路由前缀、请求头
    if ($request->is('api/*') || $request->wantsJson()) {
        return response()->json(
            ['message' => 'Internal server error'],
            500
        );
    }

    // 非API请求保留默认错误处理
    return parent::render($request, $exception);
}

步骤2：捕获致命错误（语法错误、Fatal Error等） #

Laravel 7中，可在register方法中注册致命错误的处理逻辑，确保这类早期触发的错误也能返回统一响应：

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

    // 捕获PHP致命错误
    register_shutdown_function(function () {
        $error = error_get_last();
        if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
            $exception = new \ErrorException(
                $error['message'],
                $error['type'],
                0,
                $error['file'],
                $error['line']
            );
            
            // 记录错误日志（保留默认日志逻辑）
            app('Illuminate\Contracts\Debug\ExceptionHandler')->report($exception);

            // API请求返回统一JSON响应
            $request = request();
            if ($request->is('api/*') || $request->wantsJson()) {
                response()->json(['message' => 'Internal server error'], 500)->send();
            }
        }
    });
}

关键说明 #

• 不要依赖中间件处理全局异常：中间件执行时机晚于路由解析、文件加载，无法覆盖所有错误场景。
• 保留日志记录：Laravel默认会将所有异常写入storage/logs目录，即使返回了统一响应，依然可以通过日志排查问题。
• 非API请求不受影响：上述逻辑仅针对API请求返回JSON，普通请求仍使用Laravel默认的错误页面。

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