ThinkPHP 8.1统一异常处理器核心是确保错误响应结构一致、状态码准确、不暴露敏感信息，并区分业务与系统异常；须先验证框架是否接管异常，仅继承\think\Exception的异常才被Handler::render()捕获，普通Exception需替换为HttpException等子类。
ThinkPHP 8.1 接口开发中，统一异常处理器的核心目标是：让所有错误返回结构一致、状态码准确、不暴露敏感信息，并能区分业务异常与系统异常。配置关键不在“写得多”，而在“选对入口”和“绕过陷阱”。
必须先确认框架是否真正接管异常
在任意控制器里加一行测试代码：
throw new \Exception('测试');
访问该接口后观察响应：
立即学习“PHP免费学习笔记（深入）”；
- 若看到完整堆栈或白屏 → 框架未接管，原生 PHP 错误机制仍在生效
- 若显示 think_exception.tpl 页面 → 框架已接管，可继续配置
注意：TP8.1 只捕获继承自 \think\Exception 或其子类的异常（如 HttpException、ValidateException），new \Exception() 会被完全跳过 Handler::render()。所有业务代码中的 throw new Exception() 必须立刻替换为：
- throw new \think\exception\HttpException(500, '服务异常');
- throw new \think\exception\ValidateException('参数校验失败');
- 或自定义继承 \think\Exception 的异常类（推荐）
两种配置方式，选其一即可（不可共存）
方式一：轻量级全局闭包（推荐新手）
在项目根目录创建 app/exception.php，内容如下：
<?php
use think\Response;
use Throwable;
return function (Throwable $e): Response {
if ($e instanceof \think\exception\HttpException) {
$code = $e->getStatusCode();
} else {
$code = 500;
}
return response(['code' => $code, 'msg' => $e->getMessage(), 'data' => []], $code);
};
✅ 优点：无需注册、无类加载开销、调试直观。
❌ 缺点：无法复用中间件或容器服务（如日志记录需手动调用 Log::write）。
方式二：自定义 ExceptionHandle 类
修改 config/app.php 中的 'exception_handle' => app\exception\ExceptionHandler::class，并确保该类存在：
namespace app\exception;
use think\exception\Handle;
use think\Response;
use Throwable;
class ExceptionHandler extends Handle
{
protected $ignoreReport = [
\think\exception\HttpException::class,
\think\exception\ValidateException::class,
];
public function render($request, Throwable $e): Response
{
$code = $e instanceof \think\exception\HttpException
? $e->getStatusCode()
: 500;
return response(['code' => $code, 'msg' => $e->getMessage(), 'data' => []], $code);
}
}
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
✅ 优点：可复用容器、支持 report() 方法做日志、便于扩展（如按环境返回不同字段）。
⚠️ 注意：不要继承错父类——必须是 think\exception\Handle，不是 Exception 或其他。
404 必须单独处理（它不是异常）
TP8.1 中，404 路由未匹配不走异常处理器，Route::miss() 是唯一可靠入口：
打开 route/app.php，在所有路由定义（Route::get、Route::post 等）之后，添加：
Route::miss(function () {
return response(['code' => 404, 'msg' => '接口不存在', 'data' => []], 404);
});
并检查 config/app.php 中 'url_route_must' => true 是否启用。若为 false，miss 回调永远不会触发。
验证器异常要显式引入命名空间
常见报错：Class 'ValidateException' not found，是因为没 use：
在使用 validate() 的文件顶部，必须加上：
use think\exception\ValidateException;
否则 try-catch 捕获不到，直接抛出未定义类错误，跳过你的异常处理器。
业务中建议统一用自定义异常类封装验证失败，例如：
catch (ValidateException $e) {
throw new app\exception\ParameterException($e->getMessage(), 400);
}
