ThinkPHP如何修改默认的错误显示页面_自定义异常捕获配置-ThinkPHP-PHP中文网

ThinkPHP 6 异常页面无法通过替换模板修改，因由 think\exception\Handle 统一处理；需继承并重写 render() 方法，在非调试模式下手动加载 view/404.html 或 view/500.html 视图，并显式传入状态码。

thinkphp如何修改默认的错误显示页面_自定义异常捕获配置

ThinkPHP 6 的异常页面为什么改不掉？

默认的 ThinkPHP 6 错误页（白底红字带 Trace 的页面）不是靠模板文件直接替换就能生效的，而是由 think\exception\Handle 类统一接管。你改了 view/500.html 或删了它，页面照样出来——因为根本没走到视图渲染那步。

真正起作用的是异常处理器的 render() 方法，它决定「抛出异常后返回什么内容」。开发环境默认走内置的调试渲染逻辑，不读取你写的 HTML 模板。

开发环境（app_debug = true）下，render() 直接返回带 Trace 的 HTML，无视任何自定义视图配置
生产环境（app_debug = false）才可能走你配置的错误页，但前提是异常处理器被正确重写或替换
别试图在 config/app.php 里加 'exception_handle' => 'xxx' 就完事——TP6 要求这个类必须实现 think\contract\ExceptionHandlerInterface

如何让 404 和 500 真正显示自定义 HTML 页面

核心是接管 render()，并在其中判断 HTTP 状态码，手动加载视图。不能依赖框架自动匹配模板名，TP6 不做这层映射。

推荐做法：继承默认处理器，只重写 render()，其他逻辑保持原样。示例路径：app/ExceptionHandle.php：

namespace app;

use think\exception\Handle;
use think\Response;

class ExceptionHandle extends Handle
{
    public function render(\Throwable $e): Response
    {
        if (app()->isDebug()) {
            return parent::render($e);
        }

        $code = $e instanceof \think\exception\HttpException ? $e->getStatusCode() : 500;
        $viewFile = $code === 404 ? '404' : '500';

        return view($viewFile, ['error' => $e->getMessage()], $code);
    }
}

务必保留 if (app()->isDebug()) 分支，否则开发时看不到 Trace，调试会抓瞎
view() 第三个参数是状态码，必须显式传入，否则响应头还是 200
视图文件放在 view/404.html 和 view/500.html，和控制器渲染逻辑一致，不用额外配路径
不要在 render() 里 throw 新异常，会导致无限递归

为什么 config/exception.php 里的配置项好像没用

TP6 的 config/exception.php 只控制两件事：ignore_exception（忽略哪些异常不记录）和 log（是否记录日志），它不参与页面渲染流程。很多人以为改了 exception_tmpl 就能换模板，但这个配置项在 TP6 中已被移除——那是 TP5 的遗留字段。