ThinkPHP不同版本升级后，如何适配其异常处理机制？

本文共计1187个文字，预计阅读时间需要5分钟。

TP6+ 废弃了全局异常处理器 think_exception 类，改用 thinkexceptionHandle 统一接管异常，默认不自动注册 set_exception_handler。如果配置文件 app/exception.php 或 config/exception.php 中仍使用 TP5 的配置方式，异常将直接输出 PHP 错误页面或 500 响应，而不是执行你定义的处理逻辑。

实操建议：

立即学习“PHP免费学习笔记（深入）”；

• 删除所有对 think_exception 的引用，包括类定义、extend 目录下的自定义类继承它
• 在 app/ExceptionHandle.php 中继承 thinkexceptionHandle，重写 render() 方法（注意：不是 report()）
• 确保 config/exception.php 中的 handle 配置项指向你自己的类，例如：'handle' => ppExceptionHandle::class
• TP6 默认关闭了 debug 模式下的异常显示，若需开发时看到详细堆栈，请确认 app_debug 为 true 且未被环境变量覆盖

TP6 中 render() 和 report() 的分工容易混淆

render() 负责生成 HTTP 响应内容（比如返回 JSON 错误结构或渲染错误页面），而 report() 只做日志记录、告警等副作用操作，**不能返回响应**。很多人把错误格式化逻辑全塞进 report()，结果接口照样返回空 500，因为没人在 render() 里兜底。

实操建议：

立即学习“PHP免费学习笔记（深入）”；

• report() 里只调用 Log::error() 或发 Sentry，别 echo、别 return、别 throw 新异常
• render() 必须返回 Response 实例，常见写法是 return json(['code' => -1, 'msg' => $e->getMessage()]) 或 return view('error', ['e' => $e])
• 如果用了中间件统一处理异常，要确认中间件的执行顺序——异常处理器优先级高于中间件，所以中间件里的 try/catch 捕获不到未被 render() 处理的异常

TP5.0/5.1 的 App::error() 在 TP6 中完全不可用

TP5 时代常用 App::error() 注册错误回调来捕获 E_WARNING 等非异常错误，但 TP6 废弃了 App 门面的这个方法，底层改用 thinkacadeError，且仅支持注册 errorHandler，不支持 exceptionHandler ——后者仍由 Handle 类独占。

实操建议：

立即学习“PHP免费学习笔记（深入）”；

• 不要再写 App::error(function($e) { ... })，这行代码在 TP6 会报 Call to undefined method think\facade\App::error()
• 如需捕获 PHP 错误（如未定义变量、require 失败），改用 thinkacadeError::setHandler()，传入的回调函数接收 $errno, $errstr, $errfile, $errline 四个参数
• 注意：该 handler 不会拦截 Fatal error，TP6 仍依赖 PHP 原生的 register_shutdown_function() 来兜底，这部分逻辑已封装在框架启动流程中，无需手动干预

自定义异常类在 TP6 中必须继承 thinkException 才能被正确识别

TP6 的异常处理器会根据异常类是否继承 thinkException 来决定是否走“业务异常”分支（比如跳过日志记录、返回特定状态码）。如果你沿用 TP5 的自定义异常并直接继承 Exception，它会被当作“未知异常”，强制走 render() 的默认逻辑，甚至可能被当成系统错误上报。

实操建议：

立即学习“PHP免费学习笔记（深入）”；

• 所有自定义异常类（如 UserException, ValidateException）必须显式继承 thinkException
• TP6 的 thinkException 是空类，仅作标记用途，不提供额外方法，无需担心兼容性
• 如果用了第三方验证库（如 respect/validation）抛出的异常，无法修改其继承链，此时应在 render() 中手动判断异常类型，再做差异化响应

最常被忽略的是异常类的命名空间和自动加载——TP6 默认只扫描 app 目录，如果你把自定义异常放在 common/exception/ 下，又没在 composer.json 里配 autoload，类根本不会被找到，最终 fallback 到 PHP 原生异常处理。这种问题不会报错，只会让你反复怀疑是不是配置写错了。