如何将Laravel异常转为JSON响应？当前实现返回空结果且报500错误

核心问题分析 #

1. 异常Code不一定是合法HTTP状态码
   很多PHP异常的默认code是0，而HTTP状态码要求是100-599之间的整数。当你把$e->getCode()作为响应状态码返回时，0是无效的，服务器会直接返回500错误，甚至导致响应内容无法正常输出。

2. Trace信息可能包含不可序列化内容
   $e->getTrace()返回的追踪信息里可能包含闭包、资源类型等无法被JSON序列化的数据，直接返回会导致response()->json()执行失败，最终返回空响应。

3. 状态码 fallback 逻辑有漏洞
   $status ?? 400的写法有问题，如果$e->getCode()是0，它会被当作有效值，不会触发400的 fallback，而0是无效的HTTP状态码。

修正后的代码示例 #

public function register()
{
    $this->renderable(function (Throwable $e) {
        // 确保状态码是合法的HTTP状态码，默认用500
        $status = in_array($e->getCode(), range(100, 599)) ? $e->getCode() : 500;
        
        // 只保留trace中可序列化的关键信息，比如文件、行号、方法名
        $trace = array_map(function ($item) {
            return [
                'file' => $item['file'] ?? 'unknown',
                'line' => $item['line'] ?? 'unknown',
                'function' => $item['function'] ?? 'unknown',
                'class' => $item['class'] ?? null,
            ];
        }, $e->getTrace());

        return response()->json([
            'status' => $status,
            'message' => $e->getMessage() ?: '服务器内部错误',
            'data' => $trace
        ], $status);
    });
}

额外建议 #

• 针对特定异常做单独处理，比如验证错误、模型找不到的情况，返回更合适的状态码和信息：

if ($e instanceof ValidationException) {
    return response()->json([
        'status' => 422,
        'message' => '验证失败',
        'data' => $e->errors()
    ], 422);
}

if ($e instanceof ModelNotFoundException) {
    return response()->json([
        'status' => 404,
        'message' => '请求资源不存在',
        'data' => []
    ], 404);
}

• 生产环境建议关闭trace信息返回，避免泄露敏感代码细节，只在调试环境返回。

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