thinkphp 8.0异常处理必须使用think\exception子类，原生exception被绕过；404需通过route::miss()配置；自定义错误页需按app_debug=false切换静态模板或view渲染。
ThinkPHP 8.0新手入门：新版异常处理机制与自定义错误页面【说明】
刚接触ThinkPHP 8.0的新手常被白屏、500报错或404不生效搞懵——不是代码写错了，而是TP8彻底重构了异常拦截逻辑，原生Exception被绕过、404根本不算异常、render()里echo就直接崩。必须按新版规则重配，否则所有自定义页面都无效。
确认异常是否真被框架接管
在控制器中写一行测试代码：throw new \Exception('手动抛出'); → 访问该接口，若看到完整堆栈或白屏，说明框架未接管；若显示think_exception.tpl模板，则已生效。
这一步必须先做。因为【TP8只接管继承think\Exception或其子类的异常，原生Exception直接由PHP底层捕获，完全跳过你的Handler::render()】。业务代码里写throw new Exception()等于放弃框架保护。
立刻改掉所有new Exception()，换成throw new \think\exception\HttpException(500, '服务异常')或throw new \think\exception\ValidateException('验证失败')。
配置自定义异常处理器类
方法一：通过app/exception.php全局绑定（推荐新手）
1. 在项目根目录创建app/exception.php文件
2. 写入以下内容：
<?php use think\exception\Handle;use think\Response;use Throwable;return function (Throwable $e): Response { if ($e instanceof \think\Exception\HttpException) { $code = $e->getStatusCode(); } else { $code = 500; } return response(view("error/{$code}", ['exception' => $e]), $code);};
方法二：在config/app.php中指定类路径
找到'exception_handle'配置项，设为app\exception\ExceptionHandler::class，并确保该类存在且继承think\exception\Handle。
注意：两种方式不能共存，选其一即可。用app/exception.php更轻量，无需注册provider。
让404真正走自定义页面
TP8的404不是异常，【Route::miss()是唯一可靠入口，其他任何配置对404都无效】。
第一步：打开route/app.php，把以下代码粘贴到所有Route::get()、Route::post()等路由定义之后
Route::miss(function () { return response()->view('error/404', [], 404);});
第二步：检查config/app.php中'url_route_must' => true是否启用。不开启则404永远不会触发miss回调。
第三步：确认Nginx配置中没有error_page 404指令——它会劫持PHP层响应，让你的Route::miss()完全不执行。
第四步：在app/view/error/404.html中编写纯HTML页面，禁止调用url()等依赖路由解析的函数，避免二次报错。
生产环境禁用调试信息并启用静态模板
1. 修改.env文件，设APP_DEBUG=false
2. 在config/app.php中添加配置项：
'exception_tmpl' => app()->getRootPath() . 'public/static/500.html',
3. 在public/static/500.html中写入基础HTML，例如：
<title>500</title>
<h1>服务器开小差了</h1>
这一步的关键是路径必须指向public/目录下，且文件名要和状态码一致。框架会在APP_DEBUG=false时自动加载该模板，不再执行PHP逻辑，彻底杜绝敏感信息泄露。
验证自定义异常是否生效
① 在任意控制器方法中写：abort(500, '故意触发500');
② 访问对应URL，观察是否返回app/view/error/500.html内容
③ 在浏览器开发者工具Network面板中确认响应状态码确实是500，而非200
④ 尝试发起AJAX请求（如fetch带Accept: application/json头），检查是否返回JSON格式错误信息而不是HTML
⑤ 在app/exception.php的闭包内加一句file_put_contents('/tmp/test.log', 'hit', FILE_APPEND);，访问后检查日志是否生成——这是验证handler是否真正被调用的最直接方式。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
