thinkphp5无全局异常页面模板机制，仅通过exception_handle的render()方法返回response对象实现定制；exception_tmpl仅在未配置exception_handle时对httpexception生效，且需绝对路径。
ThinkPHP5 不支持「全局异常处理页面」这种说法——它只有全局异常处理器（exception_handle），没有类似 Laravel 的 resources/views/errors/500.blade.php 那种可配置的 HTML 错误页面模板机制。
为什么 config.php 里的 exception_tmpl 不起作用
TP5 的 exception_tmpl 配置项只在「未启用自定义异常处理器」时才生效，且仅对 \think\exception\HttpException 类型（如 404、500）起作用。一旦你设置了 exception_handle（比如指向 \app\lib\exception\ExceptionHandler），框架就完全跳过该模板，直接调用你的 render() 方法。
- 常见错误现象：
exception_tmpl设了路径但页面仍是白屏或 JSON，说明exception_handle已接管 - 如果你删掉
exception_handle配置，又没清空runtime/，旧缓存可能仍走自定义逻辑 -
exception_tmpl路径必须是绝对路径（如__DIR__ . '/template/500.html'），相对路径会加载失败
想返回 HTML 页面？得手动在 render() 里输出
自定义处理器的 render() 方法是唯一出口，所有异常最终都走到这里。要返回 HTML，就不能调用 json()，而得构造响应体：
public function render(\Exception $e)
{
$debug_status = config('app_debug');
if ($debug_status) {
return parent::render($e); // 显示 TP5 默认调试页
}
// 生产环境：返回自定义 HTML 页面
$content = file_get_contents(__DIR__ . '/../../view/error/500.html');
$response = response($content, 500);
$response->header('Content-Type', 'text/html; charset=utf-8');
return $response;
}
- 注意路径：TP5 的
view目录默认不在application/下，需按实际结构调整__DIR__层级 - 不能直接
include或require模板，因为render()要求返回Response对象 - 如果用了模板引擎（如 ThinkTemplate），需手动渲染：
view('error/500', ['msg' => $e->getMessage()])，但前提是view组件已初始化（TP5.0 中未必可用）
exception_handle 配置漏写或路径错，会导致 500 白屏
这是最常踩的坑：配置项名写错、命名空间拼错、类不存在，TP5 不报错，而是静默 fallback 到空响应，浏览器显示空白或“页面错误，请稍后再试”。
- 检查
config.php中是否为：'exception_handle' => '\app\lib\exception\ExceptionHandler'（末尾无逗号，引号闭合，反斜杠是转义） - 确认文件存在且可读：
application/lib/exception/ExceptionHandler.php - 确认类继承自
\think\exception\Handle，且render()方法签名正确：public function render(\Exception $e) - 若用 IDE，Ctrl+Click 跳转类名，看是否能定位到定义处；不能则路径或命名空间有误
真正关键的不是“配个页面”，而是理解 TP5 异常流：入口 → exception_handle 类 → render() 方法 → 返回 Response。所有定制都在最后一步，其他配置项只是开关或兜底，别指望它们自动帮你生成 HTML。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
