ThinkPHP各版本异常处理器需严格遵循对应规范：5.1须继承think\exception\Handle；6.x需同时实现report()（调用parent::report）和render()；8.x须实现ExceptionHandlerInterface且通过容器注册，不可跨版本兼容。
ThinkPHP 5.1 中自定义异常处理器必须继承 think\exception\Handle
TP5.1 默认异常处理类是 think\exception\Handle，所有自定义处理器必须直接或间接继承它，否则框架不会调用你的类。常见错误是照搬旧版写法，继承了 Exception 或空类，结果异常仍走默认逻辑，控制台/页面看不到任何自定义响应。
实操建议：
- 确认
app/exception/Handler.php中的类声明为class Handler extends \think\exception\Handle - 重写
render()方法时，返回值必须是Response实例（不能 echo 或 die） - 若需记录日志，优先用
Log::record()，别在render()里直接写文件，否则可能因响应已发送而报 Warning
ThinkPHP 6.x 的异常处理类改用 think\exception\Handle + report()/render() 双方法模型
TP6 把异常处理拆成两步：先 report() 记录（可忽略），再 render() 响应。如果你只重写了 render()，但没调用父类 report()，部分异常（如数据库连接失败）可能不进日志。
常见错误现象：SQLSTATE[HY000] [2002] 这类底层异常不写日志，但页面显示正常——其实是被静默吞掉了。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
-
report()方法里务必调用parent::report($exception)，否则框架内置日志、Sentry 集成等全部失效 -
render()返回前，检查$exception instanceof HttpException再决定是否渲染 404/500 模板，避免把业务异常也套用 HTTP 模板 - TP6.3+ 开始支持
renderWithView()，但仅限HttpException子类，普通ValidateException不触发
ThinkPHP 8.x 移除了 think\exception\Handle 的构造函数参数，app_exception 配置项失效
TP8 彻底重构异常处理流程，Handle 类不再接收 $app 参数，也不再从配置读取 app_exception。如果你还在 config/exception.php 里配 handle => app\exception\Handler::class，启动会直接报 Class "app\exception\Handler" not found —— 因为框架根本不去读这个配置。
实操建议：
- TP8 的自定义处理器注册方式改为服务提供者：在
app/provider.php中添加think\exception\Handle::class => app\exception\Handler::class -
Handler类必须实现think\contract\ExceptionHandlerInterface，否则容器注入失败 -
render()方法签名变为public function render(Request $request, Throwable $e): Response，Request对象必须显式注入，不能再用app('request')
跨版本兼容写法几乎不存在，别试图用条件继承“同时适配 5.1/6.x/8.x”
三个主版本的异常处理机制差异是设计层面的断裂：5.1 是单入口 render，6.x 是双方法分离，8.x 是接口驱动 + 容器绑定。硬写一个类去 if (version_compare(...)) 分支，会导致类型校验失败、IDE 无法跳转、测试难覆盖。
真正可行的做法只有两个：
- 项目锁定一个 TP 主版本，按该版本文档写 Handler，不追求“一套代码跑三代”
- 升级大版本时，把异常处理逻辑抽成独立 service（如
AppService\ErrorReporter），在各版本 Handler 中调用它，保持核心逻辑复用，但 Handler 本身仍需按版本重写
最容易被忽略的是：TP6 和 TP8 都要求 Handler 类必须是容器可解析的，也就是不能有非可选构造参数。哪怕只是加了个 public function __construct(LoggerInterface $logger)，没在容器里 bind，启动就挂。
