ThinkPHP的Exception类不走自定义异常处理器，因为框架仅接管继承自think\Exception或其子类（如HttpException、ValidateException）的异常；原生Exception被PHP底层捕获，绕过框架处理链，退化为500白屏或调试堆栈。
ThinkPHP的Exception类为什么不走自定义异常处理器
直接 throw new Exception() 不会触发 ThinkPHP 的 render() 方法，因为框架只接管继承自 think\Exception 或其子类（如 HttpException、ValidateException）的异常。原生 Exception 被 PHP 底层捕获后，绕过框架异常处理链，最终退化为 500 白屏或调试堆栈（开发环境）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 业务代码中禁止写
throw new Exception('xxx')，改用throw new HttpException(400, '参数错误', ['code' => 1001]) - 若需统一业务码结构，应新建类继承
think\exception\HttpException，并在构造中注入$code字段 -
ValidateException是特例：它自带render()，且验证失败时由框架自动抛出，不会进你写的Handler::render() - 命令行运行（如
php think queue:work）时，HTTP 渲染逻辑不生效，需单独重写report()方法记录日志
自定义Handler类的render()方法必须返回Response实例
常见白屏或 500 错误，往往是因为 render() 里写了 echo、die() 或返回了字符串，而 ThinkPHP 要求该方法必须返回一个 think\Response 实例（如 view()、json()、response()->view() 的返回值）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 不要在
render()开头写if (app()->isDebug()) { return parent::render($e); }—— 这会导致开发期跳过你的逻辑，但生产期又因路径/模板问题失败 - 判断请求类型用
request()->isAjax()或检查request()->header('accept')是否含application/json - 渲染 HTML 模板时，用
view('error/500')而非硬编码路径；确保config/view.php中view_path正确指向app/view/ - 返回 JSON 时，显式设头：
return response()->json(['code' => 500, 'msg' => '服务异常'])->header('Content-Type', 'application/json')
404 页面为什么总不走自定义模板
ThinkPHP 默认不把路由未匹配当作异常抛出，而是由路由层直接返回空响应或 404 状态，因此 exception_handle 配置完全无效。你改了 Handler 类、关了调试模式、配了模板路径，依然看不到 error/404.html。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 开启强制路由模式：
config/app.php中设'url_route_must' => true - 在自定义
Handler::render()开头加判断：if ($e instanceof \think\exception\RouteNotFoundException) { return response($this->fetch('error/404'), 404); } - 避免在
route/app.php中配置通配路由（如Route::any('[:all]', ...)），否则所有请求都会被它吃掉，根本不会触发 404 异常 -
$this->fetch('error/404')读取的是app/view/下的模板，不是config/app.php里的exception_tmpl路径，后者仅用于框架底层 throwable 渲染，已被弃用
模板里怎么安全输出错误信息
生产环境模板中直接写 {$e.message} 或 {$e.file} 是高危操作——可能泄露绝对路径、数据库配置、token 等上下文。ThinkPHP 的模板引擎不会自动过滤敏感字段，全靠开发者手动控制。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 模板中禁止调用
$e->getTraceAsString()、$e->getTrace()、$e->getPrevious() - 只允许输出预设的安全变量，例如在
render()中传入：view('error/500', ['code' => 500, 'msg' => '系统繁忙，请稍后再试']) - 日志记录用
log()->error('Uncaught exception', ['exception' => $e]);，别写进模板变量传过去 - 若需前端埋点，可加一个唯一
trace_id字段，由中间件生成并注入到Request对象中，模板里只读$trace_id
最易被忽略的一点：APP_DEBUG = false 之后，render() 才真正启用；但很多人在本地测试时开着调试模式，以为逻辑没问题，一上生产就白屏——因为调试模式下框架强制走内置调试页，压根不调你的 Handler。
