ThinkPHP异常未捕获主因是框架异常处理器失效：TP5.1+废除App::exception，需正确配置exception_handle并继承对应Handle类，render()必须返回think\Response，Fatal Error须在index.php顶部用register_shutdown_function兜底。
ThinkPHP异常未捕获，大概率不是代码漏了 try-catch，而是框架层面的异常处理器压根没生效——尤其在 TP5.1+ 版本中，App::error 和 App::exception 已彻底失效，写了也白写。
为什么 App::exception 不起作用？
TP5.1 起移除了全局钩子注册机制，App::exception() 调用不会报错，但也不会绑定任何处理器。所有文档里还教这么写的，基本都过时了。
- 检查是否还在
public/index.php或app/common.php里调用了App::exception(...)—— 立刻删掉 - 确认异常类是否继承自
think\exception\Handle（TP6/8）或think\exception\Handle（TP5.1+），而不是旧版think\exception\Handle - 确保
config/app.php中配置项是'exception_handle' => \app\exception\Handler::class，注意开头必须有反斜杠\，漏掉就静默降级为默认处理器 - TP8 强制要求实现
think\contract\ExceptionHandler接口，且render()必须返回think\Response类型，类型提示写错会导致容器注入失败，报错却是模糊的Cannot instantiate interface
render() 返回内容被二次渲染？
常见现象：你在 render() 里写了 return json([...])，但响应体里却混进了 ThinkPHP 默认 HTML 模板的 footer 和样式——这是因为框架检测到返回值不是 think\Response 实例，自动做了兜底包装。
-
render()必须显式返回think\Response对象，例如：return json(['code' => -1, 'msg' => $e->getMessage()], 500)（该函数本质就是封装好的 Response） - 不要直接
echo或exit，这会中断框架生命周期，后续中间件、日志、钩子全失效 - 若需复用 HTML 模板（如 404 页面），得用：
return response($this->view->fetch('error/404'), 404)->contentType('text/html') - AJAX 请求下别依赖
$e->getStatusCode()，它经常是 0；应手动指定 HTTP 状态码，比如json([...], 500)
致命错误（Fatal Error）和解析错误为啥捕获不到？
像 Fatal error: Allowed memory size exhausted 或 Parse error: syntax error 这类错误，根本不会触发 render()，因为它们发生在 PHP 解析或执行早期，框架尚未加载完成。
立即学习“PHP免费学习笔记（深入）”；
- 必须在
public/index.php最顶部（require __DIR__.'/../thinkphp/start.php'之前）加兜底逻辑： register_shutdown_function(function () { $error = error_get_last(); if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) { http_response_code(500); echo '系统繁忙，请稍后再试'; error_log('[FATAL] ' . print_r($error, true)); } });- TP6.1+ 的
think\initializer\Error在 CLI 场景已内置类似逻辑，但 Web 场景仍需手动补上 - 此时日志不能走 ThinkPHP 的
Log::，容器还没初始化；得用error_log()或file_put_contents()同步写入
CLI 命令和单元测试里异常还是原样抛出？
因为 think 命令行默认不加载完整应用配置，config/app.php 里的 exception_handle 配置对命令无效。
- 在命令类的
handle()方法开头手动绑定：App::bind('think\exception\Handle', \app\exception\Handler::class) - 多应用模式下（
APP_MULTI = true），每个应用的app_exception需单独配置，不能只写在根config/app.php里 - 单元测试中，建议在
setUp()里临时注册set_exception_handler()做兜底，避免测试进程崩溃 - 别信
config/exception.php里的'ignore'配置——从 TP5.0 到 TP8，这个键从未被任何版本读取过，源码里压根没引用它
最常被忽略的是：异常处理器类路径写错、render() 返回值类型不符、以及 Fatal Error 完全不在框架处理范围内——这三个点卡住，再细的业务逻辑异常都救不回来。
