You need to enable JavaScript to run this app. PHP不同类型异常转HTTP状态码的处理方案咨询
优惠活动
大模型
产品
解决方案
定价
更多

PHP不同类型异常转HTTP状态码的处理方案咨询

PHP异常转HTTP状态码统一处理方案

一、先明确核心逻辑

不管是自定义的CustomException、PDO数据库异常、JWT相关异常还是模型抛出的异常,全部通过全局异常处理器拦截处理,别在业务代码里零散写try-catch。映射规则要兼容字符串和数字类型的错误码,同时给每种异常类型留兜底方案。

二、解决错误码类型不匹配的问题

PDO的getCode()返回的是SQLSTATE字符串(比如'42S22'),而自定义异常可能用int类型错误码,直接匹配会失败。解决办法很简单:

  • 把你的错误码映射数组的键统一存成字符串
  • 匹配时不管原错误码是int还是string,都转成string再去映射表里找

三、覆盖多类异常的映射方案

  1. 自定义异常(CustomException):直接用转成string后的getCode()匹配映射表,毕竟是自己定义的,规则可控
  2. PDOException:用$e->getCode()拿SQLSTATE码做映射,比如'42S22'(字段不存在)对应404,'23000'(唯一约束冲突)对应409
  3. JWT异常:不用错误码,直接根据异常类名映射,比如ExpiredException对应401,InvalidTokenException对应400
  4. 模型异常:要么给模型定义专属自定义异常(比如UserNotFoundException),要么根据异常类名/消息关键词映射

四、代码实现示例

1. 定义全局错误码映射表

$errorCodeMap = [
    // 自定义异常错误码(转成字符串存)
    '1001' => 400, // 参数错误
    '1002' => 401, // 未授权
    // PDO SQLSTATE码
    '42S22' => 404, // 字段不存在
    '23000' => 409, // 唯一约束冲突
    // 第三方异常类名
    'Firebase\JWT\ExpiredException' => 401, // JWT过期
    'Firebase\JWT\InvalidTokenException' => 400, // 无效JWT
];

2. 全局异常处理器

function handleException(\Throwable $e): void {
    global $errorCodeMap;
    $statusCode = 500; // 默认兜底服务器错误

    // 第一步:先按异常类名匹配(第三方异常更可靠)
    $exceptionClass = get_class($e);
    if (isset($errorCodeMap[$exceptionClass])) {
        $statusCode = $errorCodeMap[$exceptionClass];
    }
    // 第二步:再尝试错误码匹配(兼容int/string)
    else {
        $errorCode = (string)$e->getCode();
        if (isset($errorCodeMap[$errorCode])) {
            $statusCode = $errorCodeMap[$errorCode];
        }
    }

    // 特殊场景单独处理:比如数据库连接失败
    if ($e instanceof \PDOException && str_starts_with($e->getCode(), 'HY000')) {
        $statusCode = 503; // 服务不可用
    }

    // 输出JSON响应(根据你的项目调整格式)
    http_response_code($statusCode);
    echo json_encode([
        'error_code' => $e->getCode(),
        'message' => $e->getMessage(),
        'http_status' => $statusCode
    ]);
    exit;
}

// 注册全局异常处理器
set_exception_handler('handleException');
// 把PHP错误转成Throwable,统一处理
set_error_handler(function ($errno, $errstr) {
    throw new \ErrorException($errstr, 0, $errno);
});

3. 自定义异常类优化

class CustomException extends \Exception {
    // 直接从映射表拿状态码,兼容字符串错误码
    public function getStatusCode(array $map): int {
        return $map[(string)$this->getCode()] ?? 500;
    }
}

五、最佳实践总结

  • 统一拦截:用set_exception_handler接管所有异常,业务代码只负责抛异常,不用管处理
  • 类型兼容:映射表键全用字符串,匹配时强制转成string,彻底解决类型不匹配问题
  • 分层匹配:先按异常类名匹配第三方异常,再按错误码匹配自定义异常,最后兜底500
  • 特殊场景单独处理:像数据库连接失败、JWT过期这种有明确业务含义的异常,单独设置状态码
  • 配置化管理:把映射表放到单独的配置文件里,方便后期修改维护

内容的提问来源于stack exchange,提问作者nick

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.12 09:27:48