ThinkPHP全局异常处理器在app/exception/Handler.php中实现，需继承think\ExceptionHandler并在app/provider.php中绑定到think\exception\Handle接口，修改后须清空runtime/cache/和runtime/container/缓存。
全局异常处理器在哪注册
ThinkPHP 的全局异常捕获不是靠中间件或配置开关，而是通过 app/exception/Handler.php 这个类实现的。它必须继承 think\ExceptionHandler，且在 app/provider.php 中显式绑定到 think\exception\Handle 接口。
- 默认项目会自动生成该文件，但如果你删过或重装过框架，它可能不存在，此时请求出错会直接抛原始 PHP 错误，而不是走 ThinkPHP 的友好提示
- 修改后必须清空
runtime/cache/和runtime/container/，否则容器缓存会导致新 Handler 不生效 - 不要试图在
bootstrap.php或中间件里用set_exception_handler()覆盖，这会绕过框架的上下文（如 Request、Log、View），导致日志写不进runtime/log/，响应也变 raw text
如何让 404 和 500 都走同一个处理逻辑
ThinkPHP 默认把 HttpException（比如路由未匹配）和普通 Exception 分开处理，但你可以统一接管：在 app/exception/Handler.php 的 render() 方法里判断异常类型，再决定返回什么。
-
HttpException子类（如think\exception\HttpException）对应 404/405/500 等状态码，它的getStatusCode()可取真实 HTTP 状态 - 普通
Exception默认映射为 500，但你可以在render()里主动 throw 新的HttpException(404)来统一跳转 - 注意：不要在
render()里直接 echo 或 exit，ThinkPHP 依赖该方法返回Response实例；返回view()或json()是安全的
public function render($request, Throwable $e): Response
{
if ($e instanceof HttpException) {
return view('error', ['code' => $e->getStatusCode(), 'msg' => $e->getMessage()]);
}
Log::error('Uncaught exception: ' . $e->getMessage());
return json(['code' => 500, 'msg' => 'Server error'], 500);
}
开发环境和生产环境怎么区分处理
ThinkPHP 用 app_debug 配置控制是否显示详细错误页，但它不影响 Handler::render() 是否执行 —— 也就是说，无论 debug 开关如何，render() 总是会被调用。
- 当
app_debug = true时，框架默认不会调用你的render()，而是走内置的调试页面；必须在config/app.php中设置'exception_handle' => \app\exception\Handler::class才能强制启用自定义 Handler -
app_debug = false时，只要exception_handle配置存在，就一定走你的render()，此时别忘了手动记录日志，否则线上报错就“静默”了 - 别在
render()里写if (env('APP_DEBUG')) { ... }来分支逻辑，环境判断应该放在配置或中间件里，Handler 应专注“响应构造”
JSON API 场景下怎么避免 HTML 错误页污染响应
API 接口一旦触发异常，默认返回的是 HTML 格式的错误页（哪怕请求头带 Accept: application/json），这是因为 ThinkPHP 的默认异常响应不识别客户端意图。
立即学习“PHP免费学习笔记（深入）”；
- 最简单办法：在
render()开头检查$request->isAjax() || $request->header('accept') === 'application/json' - 更稳妥的做法是加一个前置判断：如果控制器命名空间含
api\或路由前缀是/api/，就强制返回 JSON - 注意
json()响应体里的字段名要和业务接口保持一致（比如都用code/msg），否则前端统一拦截器会失效 - 别忘了设置状态码：HTTP 状态码和 JSON body 里的
code是两回事，json([...], 400)才会让 Nginx 或网关识别为客户端错误
异常处理真正难的不是写几行代码，而是得想清楚：这个错误该不该被用户看到、该不该记日志、该不该触发告警、该不该影响后续中间件执行。这些决策点藏在 render() 的每一行条件判断里，而不是框架文档的某个开关上。
