PDO 默认不抛异常,需在构造时通过 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION 显式启用;否则 execute() 等方法仅返回 false,try/catch 无法捕获。

为什么 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 码和驱动错误号混用、连接复用时异常模式未继承——这些点不写进日志,线上就只能靠猜。










