PHP不同类型异常转HTTP状态码的处理方案咨询
PHP异常转HTTP状态码统一处理方案
一、先明确核心逻辑
不管是自定义的CustomException、PDO数据库异常、JWT相关异常还是模型抛出的异常,全部通过全局异常处理器拦截处理,别在业务代码里零散写try-catch。映射规则要兼容字符串和数字类型的错误码,同时给每种异常类型留兜底方案。
二、解决错误码类型不匹配的问题
PDO的getCode()返回的是SQLSTATE字符串(比如'42S22'),而自定义异常可能用int类型错误码,直接匹配会失败。解决办法很简单:
- 把你的错误码映射数组的键统一存成字符串
- 匹配时不管原错误码是int还是string,都转成string再去映射表里找
三、覆盖多类异常的映射方案
- 自定义异常(CustomException):直接用转成string后的
getCode()匹配映射表,毕竟是自己定义的,规则可控 - PDOException:用
$e->getCode()拿SQLSTATE码做映射,比如'42S22'(字段不存在)对应404,'23000'(唯一约束冲突)对应409 - JWT异常:不用错误码,直接根据异常类名映射,比如
ExpiredException对应401,InvalidTokenException对应400 - 模型异常:要么给模型定义专属自定义异常(比如
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
相关产品推荐
相关产品推荐

