PHP 8.2通过Throwable统一捕获异常与错误，结合自定义异常处理器和标准化JSON响应实现API异常统一处理；需定义分层异常类、配置框架处理器，并补充致命错误捕获、日志记录及禁用@抑制符等保障措施。
PHP 8.2 实现 API 接口异常统一处理，核心是利用 Throwable 统一捕获能力 + 自定义异常处理器 + 标准化 JSON 响应结构。它比旧版本更可靠，因为 PHP 7+ 已将传统致命错误（如 TypeError、ParseError）也纳入可捕获范围，不再直接中断脚本。
启用 Throwable 全局捕获
PHP 8.2 中所有可抛出对象（Exception 和 Error 子类）都实现 Throwable 接口。因此，一个 catch (Throwable $e) 就能覆盖绝大多数异常场景：
- 在入口文件（如
index.php）或框架中间件中设置全局处理器 - 避免只写
catch (Exception $e)，否则会漏掉TypeError等新错误类型 - 示例：
set_exception_handler(function (Throwable $e) { $code = $e instanceof HttpException ? $e->getStatusCode() : 500; $response = [ 'success' => false, 'message' => $_ENV['APP_DEBUG'] ? $e->getMessage() : '服务器内部错误', 'code' => $e->getCode() ?: 0, 'trace' => $_ENV['APP_DEBUG'] ? $e->getTraceAsString() : null ]; http_response_code($code); header('Content-Type: application/json; charset=utf-8'); echo json_encode($response, JSON_UNESCAPED_UNICODE); });
定义分层异常类体系
按业务语义划分异常类型，便于后续分类响应和日志标记：
-
ValidationException（对应 400）：参数校验失败 -
NotFoundException（对应 404）：资源未找到 -
UnauthorizedException（对应 401）：认证失败 -
ForbiddenException（对应 403）：权限不足 -
ApiException（对应 500 或自定义业务码）：通用服务异常 - 所有类均继承
Exception，并可添加getStatusCode()方法返回对应 HTTP 状态码
配置框架级异常处理器（以 ThinkPHP 为例）
若使用 ThinkPHP，需替换默认异常处理类，并确保其支持 Throwable：
立即学习“PHP免费学习笔记（深入）”；
- 创建
app\common\lib\exception\ApiExceptionHandle.php，重写render()方法 - 在
config/exception.php中配置：'exception_handle' => 'app\common\lib\exception\ApiExceptionHandle' - 关键点：判断
$e instanceof Throwable，再根据类型设置状态码与响应字段；开发环境保留详细信息，生产环境脱敏
补充关键保障措施
仅靠异常捕获还不够，还需配套机制防止遗漏：
-
注册致命错误处理器：用
register_shutdown_function()捕获未被try-catch或set_exception_handler拦截的脚本终止（如内存溢出） - 统一日志记录：所有异常必须写入日志（推荐 Monolog），包含时间、URI、请求 ID、异常类名、消息、堆栈（开发环境）
-
禁用 @ 抑制符：它会隐藏错误，破坏统一处理链路，应通过
error_reporting和set_error_handler将 PHP 错误转为异常 -
响应格式强制标准化：无论成功或失败，都走同一套 JSON 结构（如
{ "code": 0, "msg": "", "data": {} }），前端无需分支解析
