Lumen 5.6错误处理：解析假WSDL时异常抛两次的问题及解决方法

问题原因 #

这个问题的核心是双重异常处理器注册：
Lumen的Laravel\Lumen\Concerns\RegistersExceptionHandlers trait会自动注册框架默认的异常处理逻辑。当你自定义了App\Exceptions\Handler::class并替换默认处理器后，如果没有正确覆盖或跳过trait的注册逻辑，就会同时存在两个生效的异常处理器：

• 一个是框架通过trait注册的默认处理器
• 另一个是你自定义的Handler

当SoapClient解析伪造WSDL抛出SoapFault时，两个处理器都会捕获异常并输出响应，导致JSON被重复输出，最终响应格式彻底失效。注释trait代码后，默认处理器被移除，只剩自定义Handler工作，所以只会抛出一次异常。

无需修改vendor目录的解决方案 #

这里有几个可靠的解决思路，按优先级排序：

1. 自定义Handler中覆盖register方法，避免重复注册

在你的App\Exceptions\Handler类里，覆盖register方法，不要调用父类的register（父类会继承trait的注册逻辑），只保留你自己的异常处理逻辑：

<?php

namespace App\Exceptions;

use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;
use Throwable;

class Handler extends ExceptionHandler
{
    // 定义不需要上报的异常列表
    protected $dontReport = [
        // 按需添加，比如\SoapFault::class
    ];

    /**
     * 注册应用的异常处理回调
     */
    public function register()
    {
        // 自定义上报逻辑（如果需要）
        $this->reportable(function (Throwable $e) {
            // 比如上报到监控系统
        });

        // 自定义响应渲染逻辑
        $this->renderable(function (Throwable $e, $request) {
            // 统一返回JSON格式的错误响应
            return response()->json([
                'code' => 500,
                'message' => $e->getMessage(),
                'trace' => app()->environment('local') ? $e->getTraceAsString() : null
            ], 500);
        });
    }
}

2. 在bootstrap/app.php中确保正确绑定自定义Handler

确认你已经在bootstrap/app.php中正确替换了默认的异常处理器，避免重复绑定：

// 替换默认异常处理器为自定义类
$app->singleton(
    Illuminate\Contracts\Debug\ExceptionHandler::class,
    App\Exceptions\Handler::class
);

3. 给异常添加处理标记（兜底方案）

如果上面的方法还是有问题，可以在render方法中给请求添加一个标记，确保同一个异常只被处理一次：

public function render($request, Throwable $e)
{
    // 检查是否已经处理过该异常
    if ($request->attributes->get('exception_handled')) {
        return parent::render($request, $e);
    }

    // 标记异常已处理
    $request->attributes->set('exception_handled', true);

    // 针对SoapFault的特殊处理
    if ($e instanceof \SoapFault) {
        return response()->json([
            'code' => 400,
            'message' => '无效的WSDL地址：' . $e->getMessage()
        ], 400);
    }

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

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