要在ThinkPHP中用好全局异常处理，关键是确保异常按预期路径进入自定义render方法并返回think\Response实例；需区分HTTP异常、验证异常、业务异常等类型精准处理，report方法应精简堆栈、过滤敏感信息、异步写日志。
要在 ThinkPHP 中真正用好全局异常处理，关键不是“写个 render 方法”，而是让异常按预期路径走到你写的逻辑里，并根据不同场景返回合适的内容。很多同学写了类却没生效，根本原因往往卡在配置、中间件拦截或返回值类型上。
确认异常是否真进入你的 render 方法
HTTP 类异常（比如 404、403）默认被框架内置中间件提前捕获并响应，根本不会交给你自定义的 render 处理。所以光看页面没变，不代表你的类没起作用——可能异常压根没传进来。
- 在 render 方法开头加 throw new \Exception('test')，如果页面出现这个提示，说明流程走通；否则就是配置或中间件问题
- 检查是否用了
abort(404)或路由未匹配——这类会触发 HttpException，需专门判断 - CLI 环境（如命令行运行
php think run）默认不加载 app.php 配置，需手动绑定：App::bind('think\exception\Handle', \app\exception\Handler::class)
render 必须返回 think\Response 实例
返回字符串、数组或直接 echo，都会导致框架报错或二次包装成 HTML 页面，JSON 接口尤其容易因此混入无关内容。
- API 请求返回 JSON：
return json(['code' => -1, 'msg' => $e->getMessage()], 500); - Web 页面渲染模板：
return response($this->view->fetch('error/500'), 500)->contentType('text/html'); - 重定向处理 404：
return redirect('/')->code(404); - 不要用
dump()或exit，它们会中断响应流程
按异常类型精准分流处理
不能只靠 if ($e instanceof \Exception) 一刀切。ThinkPHP 内置多种异常子类，各自语义明确，应分别应对。
立即学习“PHP免费学习笔记（深入）”；
-
ValidateException：表单验证失败，适合返回json(['code'=>400, 'msg'=>$e->getMessage()]) -
HttpException：提取$e->getStatusCode()，404 可渲染模板，403 可返回纯提示 - 自定义业务异常（如
BusinessException）：建议继承\think\Exception，便于统一识别 - 开发环境保留堆栈：
config('app.app_debug') && $e instanceof \think\Exception时才调用dump($e)
report 方法要兼顾安全与可查性
report 不负责响应，只做日志记录。但默认 trace 太长、含敏感字段，容易出问题。
- 精简堆栈深度：
array_slice($e->getTrace(), 0, 8)防止日志字段溢出 - 过滤敏感数据：避免记录
$_POST、$_SERVER['HTTP_AUTHORIZATION']等 - 异步写日志更稳妥：
Log::channel('daily')->error(...)比同步写文件更可靠 - SQL 异常单独标记：
if (strpos($e->getMessage(), 'SQLSTATE') !== false)，方便快速定位数据库问题
