ThinkPHP自定义错误页面并输出详细错误信息-ThinkPHP-PHP中文网

正式环境禁用详细错误信息，app_debug=false是安全底线；render()必须返回response对象，不可echo/exit；状态码需显式设置；模板中变量须手动传入且加debug开关判断；tp8需抛think\exception子类并单独配置route::miss()处理404。

thinkphp自定义错误页面并输出详细错误信息

正式环境绝不能输出详细错误信息——这是安全底线。自定义错误页面时显示堆栈、文件路径、变量值，只应在 APP_DEBUG = true 的开发环境下启用，且必须确保线上 app_debug 为 false，否则等于把数据库密码、服务器路径全贴在首页上。

常见错误现象：页面空白、HTTP 200 状态码但内容没渲染、浏览器控制台报“Failed to load resource”。根本原因是直接 echo 模板内容或调用 exit()，绕过了框架的响应生命周期。

TP6/TP8 要求 render() 方法必须返回 \think\Response 实例，推荐用 response()->view() 或 app('view')->fetch()
状态码必须显式设置：response()->view('error/500', $vars)->code(500)，否则默认是 200
模板中不能直接访问 $exception，得手动传入：compact('exception', 'message', 'file', 'line')
若用 app('view')->fetch()，需确保 config/view.php 中 'view_path' 指向正确目录，且该路径下存在可读的 error/500.html

想在 500 页面里看到 $exception->getTraceAsString() 或 $exception->getFile()，不能无条件渲染——必须加开关判断，否则上线即泄露敏感信息。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

在 render() 里先判断：if (config('app.app_debug')) { $vars['trace'] = $exception->getTraceAsString(); $vars['file'] = $exception->getFile(); $vars['line'] = $exception->getLine(); }
模板中用 {if isset($trace)}<pre class="brush:php;toolbar:false;">{$trace}</pre>{/if} 控制是否展示（ThinkPHP 模板语法）
注意：TP8 中原生 Exception 不会被框架捕获，必须抛 \think\Exception 子类，否则 render() 根本不执行
TP8 的 404 不走 render()，得单独在 route/app.php 里配 Route::miss()，否则改了 render 也看不到 404 自定义页

报 “View not found” 不一定是文件不存在，大概率是路径、上下文或变量注入方式错了。

模板路径别写相对路径：'error/500' 可能失败；推荐用绝对路径：app()->getAppPath() . 'view/error/500.html'
别在 render() 里 new \think\View() —— 它绕过容器单例，导致配置（如 tpl_replace_string）失效；必须用 app('view')->fetch()
变量数组必须完整：如果模板里写了 {$message}，但 compact() 没包含 message，就会空值或报 notice；建议统一用 array_merge(['message' => $exception->getMessage()], $debugVars)