Laravel9中如何捕获自定义类方法抛出的自定义错误？

为什么HttpResponseException拿不到自定义消息？ #

HttpResponseException是Laravel框架设计用来直接终止请求并返回响应的异常，它的构造函数接收的是Response实例，而非普通异常的消息字符串。所以你调用$e->getMessage()时返回空，getCode()返回0，因为这些属性并没有被赋值。

解决方案1：继续使用HttpResponseException，获取内部响应内容 #

如果你坚持用这个异常，可以通过getResponse()方法取出它携带的响应对象，再解析其中的自定义消息：

catch (HttpResponseException $e) {
    // 获取异常携带的响应实例
    $response = $e->getResponse();
    // 解析响应内容为数组
    $responseData = json_decode($response->getContent(), true);
    // 提取自定义消息，默认值兜底
    $customMessage = $responseData['message'] ?? '请求处理失败';
    // 获取响应状态码
    $statusCode = $response->getStatusCode();

    \Log::info($customMessage);
    return response()->json(['message' => $customMessage], $statusCode);
}

解决方案2：自定义业务异常（更推荐） #

HttpResponseException属于框架级异常，不适合用来传递业务逻辑的自定义错误信息。更规范的做法是创建自定义异常类：

步骤1：创建自定义异常

在app/Exceptions目录下新建CustomValidationException.php：

<?php

namespace App\Exceptions;

use Exception;

class CustomValidationException extends Exception
{
    // 自定义异常，直接继承Exception即可
    public function __construct(string $message = "", int $code = 422, ?Throwable $previous = null)
    {
        parent::__construct($message, $code, $previous);
    }
}

步骤2：在自定义类中抛出异常

修改CustomClass的代码，替换HttpResponseException为自定义异常：

<?php

use App\Exceptions\CustomValidationException;
use Illuminate\Database\Eloquent\ModelNotFoundException;

class CustomClass
{
    public function method(): array
    {
        if (false) { // 你的业务判断条件
            // 直接抛出带自定义消息和状态码的异常
            throw new CustomValidationException($validated['message'], 422);
        }

        // 其他业务逻辑...
        return [];
    }
}

步骤3：在控制器中捕获自定义异常

try {
    $imageUploadSuccess = $customClass->method(...);
} catch (ModelNotFoundException $e) {
    return response()->json(['message' => 'Item not found'], 404);
} catch (CustomValidationException $e) {
    // 直接通过getMessage()和getCode()获取自定义内容
    \Log::info($e->getMessage());
    \Log::info($e->getCode());
    
    return response()->json(['message' => $e->getMessage()], $e->getCode());
}

可选：全局处理自定义异常

如果不想在每个控制器里都捕获异常，可以在app/Exceptions/Handler.php中全局处理：

// 在Handler类的register方法中添加
$this->renderable(function (CustomValidationException $e, $request) {
    return response()->json([
        'message' => $e->getMessage()
    ], $e->getCode());
});

这样控制器里无需手动捕获，框架会自动返回对应的JSON响应。

额外提示 #

你原来的CustomClass中用use导入异常的写法是正确的，但注意use是用来导入类，不是trait，所以不要混淆语法。

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