ThinkPHP如何自定义异常页面样式_ThinkPHP友好错误提示教程【教程】-ThinkPHP-PHP中文网

thinkphp 6 异常页面不能直接修改 public/static/ 下文件，因其使用 think-exception 组件，模板内置在 vendor/topthink/think-exception/src/render/ 中；需在 app/exception/ 下创建 httpexceptionrender.php 并继承对应基类，且仅在 app_debug = false 时生效。

thinkphp如何自定义异常页面样式_thinkphp友好错误提示教程【教程】

ThinkPHP 6 的异常页面为什么不能直接改 public/static/ 下的文件

因为 ThinkPHP 6 默认使用 think-exception 组件渲染异常页面，所有 HTML 模板都内置在 vendor/topthink/think-exception/src/render/ 里，不是从 public 目录读取。你改 public/static/ 或 resources/view/ 下的文件完全无效。

真正生效的位置是：app/exception/HttpExceptionRender.php（需手动创建）或通过配置指定自定义渲染器。

若未启用 APP_DEBUG = false，系统才走自定义异常渲染逻辑
APP_DEBUG = true 时，无论怎么配都会显示调试模式下的详细报错页
自定义渲染类必须继承 think\exception\HttpExceptionRender 或 think\exception\ThrowableRender

如何写一个最简可用的自定义异常渲染器

在 app/exception/ 下新建 HttpExceptionRender.php：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

<?php namespace app\exception;

use think\exception\HttpExceptionRender as BaseRenderer;

class HttpExceptionRender extends BaseRenderer
{
    public function render(\Throwable $e): \think\Response
    {
        if ($e instanceof \think\exception\HttpException) {
            return response($this->fetch('error/404'), 404);
        }
        return response($this->fetch('error/500'), 500);
    }
}

然后在 config/exception.php 中指定：

'render' => \app\exception\HttpExceptionRender::class,

$this->fetch() 会按视图路径规则加载模板，比如 error/404 对应 resources/view/error/404.html
模板里可直接用 {$e.message}、{$e.file}、{$e.line} 等变量（但生产环境建议隐藏敏感信息）
别忘了给 resources/view/error/ 目录加对应 HTML 文件，否则会报 Template not found

为什么 404 页面总是跳到默认白屏，而不是你的模板

常见原因是路由没匹配上，导致框架根本没走到控制器层，直接由底层抛出 think\exception\RouteNotFoundException —— 它不继承 HttpException，所以你上面的 render() 方法里那个 if 判断就跳过了。

解决办法：去掉 if 判断，统一处理所有 \Throwable；或显式捕获 RouteNotFoundException
更稳妥的写法是重写 render() 时不判断类型，直接返回 response($this->fetch(...))
另一个坑：如果用了多应用模式（app/multi/），要确认 render 配置写在对应应用的 config/exception.php 里，而不是根配置