ThinkPHP 8.0全局异常捕获默认不生效，根本原因是app_exception配置未写入config/app.php、CLI环境未手动绑定、render()未返回Response实例，且原生Exception不被接管、404须用Route::miss()单独处理。
ThinkPHP 8.0 的全局异常捕获默认不生效，不是代码写错了，而是配置位置、环境适配、返回值类型三处任一出错就会失效。
app_exception 配置必须写在 config/app.php 里
TP8 不再自动加载 app/exception.php，只认 config/app.php 中的 'app_exception' 配置项。常见错误是把配置写在了其他文件（比如 app.php 或中间件配置里），或者多应用模式下只改了根配置，子应用的 config/app.php 没同步。
确认方式：打开 config/app.php，检查 return 数组中是否包含：
'app_exception' => \app\exception\ExceptionHandle::class,
注意：\app\exception\ExceptionHandle 类必须存在且继承 think\exception\Handle；CLI 环境（如 php think run）不会自动加载该配置，需手动绑定：
立即学习“PHP免费学习笔记（深入）”；
App::bind('think\exception\Handle', \app\exception\ExceptionHandle::class);
这行要加在 think 命令入口文件（通常是项目根目录下的 think 文件）顶部。
render() 必须返回 think\Response 实例
如果 render() 方法里写了 return json([...]) 或 return ['code' => 500]，框架会二次包装成 HTML 页面——哪怕你看到响应体是 JSON，实际 HTTP body 里还混着框架 footer 和样式。
- API 场景下，显式用
json()构造响应：return json(['code' => -1, 'msg' => $e->getMessage()], 500); - Web 页面场景下，显式构造视图响应：
return response($this->view->fetch('error/500'), 500)->contentType('text/html'); - 绝对不要在
render()里echo、exit、die或直接return []，这些都会跳过响应生命周期
原生 Exception 不会被框架接管
在控制器或服务里写 throw new Exception('xxx')，TP8 完全不处理——它只会被 PHP 底层捕获，显示白屏或原始堆栈。框架只接管继承自 think\Exception 及其子类的异常。
正确做法：
- 业务异常用
throw new \think\exception\HttpException(500, '服务异常'); - 验证失败用
throw new \think\exception\ValidateException('用户名已存在'); - 或使用助手函数：
exception('参数错误', 400, \think\exception\HttpException::class);
如果你有自定义异常类，确保它继承 \think\exception\HttpException 或至少 \Exception，并在 render() 中做类型判断。
404 不是异常，Route::miss() 是唯一可靠入口
TP8 中 404 路由未匹配不走异常流程，app_exception 配置对它完全无效。想统一处理 404 页面，只能靠路由层的 Route::miss()。
操作步骤：
- 打开
route/app.php，把以下代码粘贴到所有Route::get()、Route::post()等定义之后：
Route::miss(function () {
return response()->view('error/404', [], 404);
});
- 确认
config/app.php中'url_route_must' => true已启用，否则miss()永远不会触发
别试图用 HttpException(404) 替代，它解决不了路由未匹配问题。
