ThinkPHP全局异常捕获由框架在请求末尾统一接管，核心是正确配置exception_handle、继承think\exception\Handle类，并在render()返回Response、report()精简日志。
ThinkPHP 的全局异常捕获不是靠写几个 try-catch 实现的，而是由框架在请求生命周期末尾统一接管所有未被捕获的异常。核心在于正确配置、继承规范类、并在 render() 和 report() 两个方法中分别处理“展示”和“记录”逻辑。
配置必须准确，否则根本不会触发
全局异常处理器是否生效，第一关是配置路径。必须在 config/app.php 中明确设置：
-
'exception_handle' => \app\exception\Handler::class（TP6+ 推荐写法）或'app_exception' => \app\exception\Handler::class（部分版本仍用此键名） - 该类必须真实存在，且继承自
think\exception\Handle - 多应用模式下，每个子应用的
app.php都要单独配，根配置不生效 - 命令行环境（如
php think run）默认不加载完整配置，需在入口手动绑定：App::bind('think\exception\Handle', \app\exception\Handler::class)
render() 方法必须返回 Response 实例
这是最容易出错的一环。框架要求 render() 必须返回一个 Response 对象，否则会被自动包装成默认 HTML 页面，哪怕你写了 JSON 也会被污染。
- API 请求建议统一返回：
return json(['code' => -1, 'msg' => $e->getMessage()], 500); - Web 页面可渲染模板：
return response($this->fetch('error/500'), 500)->contentType('text/html'); - 切勿在
render()中使用echo、dump()或exit()，它们会破坏响应流程 - 区分异常类型更稳妥：
if ($e instanceof \think\exception\HttpException) { return response(..., $e->getStatusCode()); }
report() 方法专注日志，但要精简与脱敏
report() 不影响用户响应，只负责记录。但直接打全量堆栈可能撑爆数据库字段，或泄露敏感信息。
立即学习“PHP免费学习笔记（深入）”；
- 限制堆栈深度：
$trace = array_slice($e->getTrace(), 0, 10); - 过滤敏感上下文：避免记录
$_POST、$_SERVER['HTTP_AUTHORIZATION']等 - 异步写日志更安全：
Log::channel('daily')->error('Uncaught exception', ['message' => $e->getMessage(), 'file' => $e->getFile(), 'line' => $e->getLine()]); - 对 SQL 相关异常（如
PDOException）可做特殊标记，便于监控告警
常见异常类型要主动纳入处理链
ThinkPHP 默认不把 ValidateException、RouteNotFoundException 等业务异常纳入 HttpException 继承链，所以它们不会自动走 render() —— 必须显式处理。
- 在
render()开头加判断：if ($e instanceof \think\exception\ValidateException) { return json(['code' => 422, 'msg' => $e->getError()], 422); } - 让 404 走自定义模板：
if ($e instanceof \think\exception\RouteNotFoundException) { return response($this->fetch('error/404'), 404); } - 自定义业务异常（如
BusinessException）建议继承Exception并设$code为 HTTP 状态码，方便复用
