ThinkPHP升级后自定义异常处理类不生效，90%因基类继承错误、配置路径错误或版本接口变更导致注册链断裂；TP6需继承think\exception\Handle并实现report()和render()，TP8则须实现ExceptionHandlerInterface且手动注册到容器，config/exception.php中handle配置已失效。
升级ThinkPHP后自定义异常处理类不生效，90%的情况不是代码写错了，而是类没继承对基类、配置路径写错，或者TP版本升级导致接口变更——注册链断了，框架根本没调用你的类。
先确认TP版本和对应接口要求
TP6.x和TP8.x的异常处理器接口完全不同，混用必失效。
TP6必须同时实现report()和render()两个方法，且类需继承think\exception\Handle；TP8则必须实现\think\contract\ExceptionHandlerInterface，并手动注册到容器，【config/exception.php中的'handle'配置已完全无效】。
打开composer.json查看"topthink/framework"版本号：6.x开头走TP6路径，8.x开头必须按TP8重写。
立即学习“PHP免费学习笔记（深入）”；
TP6升级后不生效的修复步骤
第一步：检查类是否继承正确基类
确保你的异常类声明为class Handler extends \think\exception\Handle，而不是extends \think\Exception或空继承——继承错误会导致report()和render()不被框架识别。
第二步：确认report()里调用了父类逻辑
public function report(Throwable $exception): void { parent::report($exception); }——漏掉这句，日志通道全断，PDO异常、数据库连接失败等底层错误不会进日志，但页面却“看起来正常”。
第三步：验证render()返回值类型
必须返回\think\Response实例，不能echo、die、return []或return view(...)字符串。正确写法是return response(view('error/500'), 500)或return json(['msg' => $e->getMessage()], 500)。
TP8升级后不生效的修复步骤
方法一：改配置位置
把原config/exception.php里的'handle' => \app\exception\Handler::class整段删掉，改为在config/app.php的return []数组中添加：'app_exception' => \app\exception\Handler::class。
方法二：补注册逻辑（尤其CLI环境）
TP8命令行运行（如php think run）时，config/app.php不自动加载，必须在think入口文件顶部手动绑定：App::bind('think\exception\Handle', \app\exception\Handler::class)。
方法三：检查render()签名和返回值
签名必须为public function render(Request $request, Throwable $e): Response，【Request参数必须显式注入，不能再用app('request')】；返回值必须是\think\Response实例，否则框架会二次包装，导致JSON响应混入HTML footer。
通用排查动作
① 检查config/app.php中键名是否拼错：必须是'app_exception'，写成'exception_handler'或'exception_handle'都无效。
② 确认命名空间与文件路径严格一致：类app\exception\Handler必须存于app/exception/Handler.php，改过路径需同步更新composer.json的"autoload"映射。
③ 验证是否触发了异常：TP6+默认不将Notice/Warning转为异常，只有throw new Exception或未捕获致命错误才进render()；可在控制器里写throw new \Exception('test');强制触发。
④ 清空runtime/目录：缓存可能残留旧处理器引用，删掉runtime/下所有内容再试。
