Laravel 9自定义ServiceException未触发reportable闭包问题求助

核心原因 #

你的ServiceException类中定义了空的report()方法，Laravel异常处理机制中，如果自定义异常自带report()方法，会优先执行该方法，跳过Handler中注册的reportable闭包。这就是针对ServiceException的闭包从未被调用的直接原因。

解决方案步骤 #

1. 移除或修改ServiceException的report()方法 #

直接删除ServiceException中的report()方法，Laravel就会回到Handler中寻找对应的reportable闭包逻辑：

// App\Exceptions\ServiceException.php
<?php

namespace App\Exceptions;

use Exception;

class ServiceException extends Exception
{
    // 移除空的report()方法

    /**
     * Render the exception into an HTTP response.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function render($request, $exception)
    {
        if (! $request->ajax()) {
            // view('error_handler', compact('exception'));
        }

        return response()->json([
            'code' => $exception->getCode(),
            'status' => 'error',
            'message' => $exception->getMessage(),
            'data' => 'sample data',
        ]);
    }
}

如果需要保留report()方法做前置处理，可在方法内调用parent::report()触发Handler的闭包逻辑：

public function report()
{
    // 自定义前置逻辑
    parent::report(); // 让Laravel继续执行Handler中的reportable闭包
}

2. 修正Handler中的reportable闭包逻辑 #

避免使用echo和die破坏应用流程，改用Laravel日志系统对接Papertrail（需提前在config/logging.php配置papertrail通道）：

// App\Exceptions\Handler.php
$this->reportable(function (ServiceException $e) {
    \Log::channel('papertrail')->error('ServiceException触发', [
        'message' => $e->getMessage(),
        'code' => $e->getCode(),
        'trace' => $e->getTraceAsString(),
    ]);
});

3. 验证异常上报流程 #

你在Service中捕获异常后重新抛出、Controller中捕获调用report($e)的流程是正常的，移除ServiceException的report()方法后，report($e)会正确触发Handler中对应的闭包逻辑。

Laravel错误处理关键要点 #

• reportable闭包优先级：异常类自带report()方法时优先执行，否则遍历Handler中注册的闭包，匹配第一个类型兼容的执行。
• dontReport数组：列出的异常类型会被完全跳过上报，你的代码已注释ServiceException::class，无问题。
• report()函数：手动调用report($e)会触发完整上报流程，和自动捕获异常的逻辑一致。

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