PDO异常处理技巧全解析

PDO默认不抛出异常，导致try/catch无法捕获数据库错误，必须在初始化时通过PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION显式启用异常模式——漏掉这一步，所有操作（包括execute、query甚至commit/rollback）都只会静默返回false或触发警告，让错误悄无声息地溜走；而一旦正确开启，不仅能精准进入catch块，还能通过getMessage()、errorInfo等获取含SQL语句、绑定参数和驱动原生错误码的完整上下文，尤其在事务处理和调试阶段至关重要——别再让“HY000”成为你线上排查的唯一线索。

为什么 try/catch 捕不到 PDO 错误

默认情况下，PDO 不抛出异常，所有错误都静默失败或返回 false。你写了 try/catch 却没捕获到任何异常，不是语法错了，是 PDO 还没被“激活”成异常模式。

• 必须在创建 PDO 实例时，通过 options 显式开启：PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
• 漏掉这行，execute()、query() 出错只会返回 false，catch 完全收不到
• 不能靠后续调用 setAttribute() 补救——部分驱动（如 MySQL）在连接建立后改这个属性无效

PDO::ERRMODE_EXCEPTION 的三种行为差异

它不只是“让报错变异常”，不同值直接影响错误发生时机和堆栈深度：

• PDO::ERRMODE_SILENT：所有错误设 errorCode()，不提示也不中断，最容易漏掉问题
• PDO::ERRMODE_WARNING：触发 E_WARNING，但脚本继续执行，catch 依然捕不到
• PDO::ERRMODE_EXCEPTION：唯一能进 catch 的选项，且异常包含完整 SQL、绑定参数、驱动错误码（如 HY000）

示例初始化写法：

$pdo = new PDO($dsn, $user, $pass, [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);

常见误捕场景：事务里 commit() 和 rollback() 也要包

很多人只给 prepare() 和 execute() 加 try，却忘了事务提交本身也可能失败——比如唯一键冲突延迟到 commit() 才爆发。

• commit() 失败时，PDO 仍会抛 PDOException，但此时连接可能已处于不可用状态
• rollback() 也应放在 catch 块里，但要加 if ($pdo->inTransaction()) 判断，否则空事务调用会报错
• 不要在 catch 里直接重试 commit()——多数驱动不支持自动恢复，得重新开始事务

调试时别忽略 getMessage() 和 getTraceAsString()

生产环境通常隐藏详细错误，但开发阶段必须看清楚异常内容，否则光靠“SQLSTATE HY000”没法定位。

• $e->getMessage() 包含驱动原生错误信息，例如 MySQL 的 “Duplicate entry 'xxx' for key 'uk_name'”
• $e->getCode() 是 SQLSTATE 码，不是 MySQL 错误号；要拿原生号得用 $e->errorInfo[1]
• 堆栈里常出现 PDOStatement::execute()，说明问题出在参数绑定或 SQL 语法，不是连接层

快速打印建议：

catch (PDOException $e) {
    error_log($e->getMessage() . ' | ' . json_encode($e->errorInfo));
    throw $e;
}

事务回滚失败、SQLSTATE 码和驱动错误号混用、连接复用时异常模式未继承——这些点不写进日志，线上就只能靠猜。

理论要掌握，实操不能落！以上关于《PDO异常处理技巧全解析》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！