Yii2中SQL报错需用try-catch捕获yii\db\Exception,通过$e->errorInfo[1]获取MySQL错误号(如1062)、$e->errorInfo[0]获取SQLSTATE,避免依赖不稳定的getMessage()。

Yii2 中执行 SQL 报错后怎么拿到具体错误信息
直接用 $model->save() 或 ActiveRecord::updateAll() 失败时,默认只返回 false,不暴露错误原因。必须主动捕获异常或检查底层 PDO 状态。
最可靠的方式是开启事务并用 try-catch 捕获 Exception,同时确保数据库组件配置了 'enableSchemaCache' => false(开发环境),避免缓存掩盖真实报错。
- 增删改操作若没手动 throw 异常,
$model->getErrors()只返回验证失败项,不是 SQL 执行错误 -
createCommand()->execute()出错会直接抛yii\db\Exception,其$errorInfo属性含原生驱动错误码和消息 - MySQL 场景下,常见错误如
SQLSTATE[23000]: Integrity constraint violation表示外键或唯一索引冲突,需解析$exception->errorInfo[1](MySQL 错误号)进一步判断
用 createCommand 执行原生 SQL 时如何安全获取错误详情
绕过 ActiveRecord 直接执行语句时,execute() 和 queryAll() 都不会静默吞掉错误——它们要么成功返回结果,要么抛出 yii\db\Exception。
关键点在于别只写空 catch,要读取异常对象的结构化字段:
try {
Yii::$app->db->createCommand("INSERT INTO user (name) VALUES ('test')")->execute();
} catch (\yii\db\Exception $e) {
// $e->getMessage() 是带 SQL 的简略提示
// $e->errorInfo 是数组:[SQLSTATE, driverCode, message]
Yii::error('DB error: ' . json_encode($e->errorInfo));
}
-
$e->errorInfo[0]是 SQLSTATE(跨数据库标准码) -
$e->errorInfo[1]是 MySQL errno 或 PostgreSQL SQLSTATE 子类码,用于精确分支处理(如 errno=1062 表示重复键) - 不要依赖
$e->getMessage()做逻辑判断,内容不稳定且含敏感 SQL 片段
ActiveRecord 保存失败但 getErrors() 为空的原因
这通常说明验证通过了,但数据库层拒绝写入——比如字段长度超限、NOT NULL 字段传了 null、触发器报错,这些都不会进模型验证规则,也就不会塞进 getErrors()。
此时必须回退到数据库连接层面查问题:
- 确认是否在
save()前调用了$model->validate(),否则getErrors()必然为空 - 强制开启 AR 日志:
'enableLogging' => true在 db 组件中,配合Yii::getLogger()->flush()查看实际发出的 SQL 和返回状态 - 对关键操作加事务包装,利用
Yii::$app->db->getTransaction()->getIsActive()判断是否已处于事务中,避免嵌套异常丢失上下文
批量操作(insertAll/updateAll)出错时的调试技巧
这类静态方法不走模型实例,因此完全不触发 beforeSave 或验证,错误只能从异常里挖。
注意 updateAll() 返回的是影响行数(int),不是布尔值;0 不代表失败,可能是条件没匹配到任何记录——真失败才会抛异常。
-
insertAll()遇到某一行违反约束(如唯一索引),整个批次会回滚(取决于引擎和事务设置),但默认不告诉你哪一行、哪个字段炸了 - 调试时可临时拆成单条
createCommand()->insert()循环,配合 try-catch 定位具体数据 - PostgreSQL 下可用
ON CONFLICT DO NOTHING语法替代部分场景,但 Yii2 原生不支持该扩展写法,得手写createCommand()
真正难处理的不是“怎么拿错误”,而是错误发生时事务状态是否干净、日志是否留痕、以及能否把驱动级错误码映射成业务可理解的提示。别省略 errorInfo 的三个字段,尤其是第二个——它才是区分“主键冲突”和“连接超时”的唯一依据。











