ThinkPHP6.x可通过继承Handle类重写render()方法或配置静态exception_tmpl模板实现自定义错误页面；前者支持动态渲染与异常类型判断，后者以纯静态HTML杜绝代码执行风险，均需关闭APP_DEBUG以保障生产环境安全。
如果您在使用ThinkPHP6.x开发应用时遇到未捕获的异常或错误，系统默认会显示不友好的调试信息，可能暴露敏感路径或配置细节。以下是实现自定义错误页面与全局异常捕获的多种方法：
一、继承Handle类重写render()方法
该方法是TP6.x推荐的主流方式，通过自定义异常处理器接管所有未捕获异常，并按需返回JSON响应或渲染安全HTML模板，确保生产环境不泄露堆栈信息。
1、在app目录下创建ExceptionHandle.php文件，内容为：
2、声明命名空间并引入必要类：namespace app; use think\exception\Handle; use think\Response;
立即学习“PHP免费学习笔记（深入）”；
3、定义类继承think\exception\Handle：class ExceptionHandle extends Handle
4、重写render()方法，在其中判断debug状态：if (app()->isDebug()) { return parent::render($e); }
5、非debug状态下，根据异常类型获取状态码：$code = $e instanceof \think\exception\HttpException ? $e->getStatusCode() : 500;
6、调用view()显式加载对应模板并传入状态码：return view($code === 404 ? '404' : '500', ['error' => $e->getMessage()], $code);
7、确保config/app.php中配置项'exception_handle'指向该类：'exception_handle' => \app\ExceptionHandle::class
二、配置静态exception_tmpl模板并禁用调试模式
该方式通过纯静态HTML响应异常，完全隔离业务逻辑，防止模板中执行PHP代码导致信息泄露，适用于对安全性要求极高的部署场景。
1、在.env文件中设置：APP_DEBUG=false
2、在config/app.php中配置exception_tmpl选项，指向静态模板路径：'exception_tmpl' => app()->getThinkPath() . 'tpl/think_exception.tpl'
3、创建该模板文件，仅包含基础HTML结构与提示文字，禁止使用任何
4、确认模板文件权限为只读，且不依赖外部CSS/JS资源（或内联嵌入）
5、验证访问不存在路由时是否返回该静态页而非白屏或调试页
三、通过路由缺失闭包触发404页面
TP6.x默认将404视为路由层行为而非异常，因此不会进入render()流程；此方案绕过异常处理机制盲区，直接在路由层拦截并渲染预设模板。
1、打开route/app.php文件
2、添加Route::miss()闭包：Route::miss(function () { return view('public/404'); });
3、确保public/404.html文件存在于public目录下
4、该文件内容应为纯HTML，不含任何PHP逻辑、数据库连接或变量输出
5、测试访问一个不存在的URL路径，确认返回public/404.html内容
四、使用全局中间件拦截500响应并替换内容
该方法在响应已生成但状态码为500时进行兜底替换，适用于无法修改异常处理器或需兼容遗留配置的场景，可与render()方案共存。
1、在app/middleware.php中注册全局中间件数组
2、创建中间件类，例如app/middleware/ExceptionPage.php
3、在handle()方法中获取响应对象：$response = $next($request);
4、判断响应状态码是否为500：if ($response->getCode() === 500)
5、替换响应内容为安全页面：return view('public/500');
6、确保public/500.html模板独立存在且不依赖控制器、模型或任何业务逻辑
五、通过register_shutdown_function兜底致命错误
TP6.x的Handle类无法捕获Parse error、Fatal error等致命错误，此方案利用PHP原生机制在脚本终止前检查最后错误，防止白屏或空白响应。
1、在public/index.php顶部添加：register_shutdown_function(function () {
2、调用error_get_last()获取最后错误：$error = error_get_last();
3、判断$error是否为非空数组且属于E_ERROR/E_PARSE/E_CORE_ERROR类型
4、记录日志：file_put_contents(LOG_PATH . 'fatal_error.log', print_r($error, true), FILE_APPEND);
5、输出预设安全HTML：echo file_get_contents(PUBLIC_PATH . '500.html');
6、强制退出：exit(1);
7、注意：Swoole环境下该函数行为不稳定，建议改用Swoole\Error监听器
