优雅处理错误：thinkphp使用全局异常捕获【健壮性】-ThinkPHP-PHP中文网

thinkphp 6 的 render 方法需调用 parent::render($request, $e) 保留默认异常处理，返回 response 实例；dbexception 需在 config/exception.php 中注册映射；report 中应调用 $e->getsql() 获取 sql 日志；响应必须为 response 实例且 content-type 正确。

优雅处理错误：thinkphp使用全局异常捕获【健壮性】

ThinkPHP 6 的 `render` 方法怎么写才不吞异常？

默认的全局异常处理器会把所有错误转成 500 页面，但开发时你根本看不到原始报错堆栈——render 方法如果没调用父类逻辑或没返回响应，就会静默失败。

正确做法是保留 ThinkPHP 自带的渲染能力，只做定制化干预：

在 app/exception/Handler.php 中重写 render，但第一行先判断是否需要自定义处理（比如只拦截 ValidateException）
不需要拦截的异常，必须显式调用 parent::render($request, $e)，否则框架底层日志、调试信息全丢
返回值必须是 Response 实例，不能直接 return json(...)，否则中间件链中断

public function render(Request $request, Throwable $e): Response
{
    if ($e instanceof ValidateException) {
        return json(['code' => 400, 'msg' => $e->getMessage(), 'data' => []]);
    }
    return parent::render($request, $e); // 这行不能删
}

如何让数据库异常也走统一 JSON 格式？

TP6 默认把 PDOException 和 Throwable 都归为“致命异常”，直接进 render，但你可能发现它没进你的 Handler——因为数据库异常常被事务层提前捕获并抛出 DbException，而这个类不在默认异常映射里。

解决方案不是改框架源码，而是扩展异常映射：

在 config/exception.php 中添加 'think\db\exception\DbException' => \app\exception\Handler::class
确保 DbException 被识别后，能进你的 render 方法统一处理
注意：TP6.1+ 的 DbException 继承自 Throwable，但早期版本需手动注册

`report` 方法里记录日志，为什么线上还是看不到 SQL 错误？

report 只负责日志记录，不参与响应输出。很多开发者以为在这里 Log::error($e->getTraceAsString()) 就够了，但数据库异常的 SQL 语句默认不包含在 getMessage() 里，堆栈里也常被脱敏。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

真正要拿到可排查的 SQL，得从异常实例里主动提取：

DbException 有 getSql() 方法，直接调用即可
PDOException 需检查 $e->errorInfo 或向上找 getPrevious() 链
别只记 $e->getMessage()，它可能只是 “SQLSTATE[HY000]: General error”

public function report(Throwable $e): bool
{
    if ($e instanceof DbException) {
        Log::error('DB Error: ' . $e->getSql() . ' | ' . $e->getMessage());
    }
    return parent::report($e);
}