Yii2更新数据报错应先解析PDOException三要素：SQLSTATE、错误码（如1062）、描述文字，结合真实SQL、表结构、rules()及数据库约束综合排查，而非盲目改代码。
Yii2 更新数据时抛出 SQL 报错，别急着改代码——90% 的情况是错误信息里已经写了根本原因，只是你没看到或没读对位置。
看懂报错信息里的关键三要素
Yii2 抛出的 PDOException 通常带三段关键信息：SQLSTATE、错误码（如 1062）、描述文字。这三者必须一起看：
-
SQLSTATE[23000]+1062+ “Duplicate entry 'xxx' for key 'yyy'” → 唯一键冲突，yyy是索引名，xxx是冲突值，立刻查该索引对应字段是否重复 -
SQLSTATE[42S22]+1054+ “Unknown column 'statuss' in 'field list'” → 字段名拼错（多了一个s），不是模型没定义，是 SQL 里写错了 -
SQLSTATE[HY000]+1364+ “Field 'xxx' doesn't have a default value” → 某字段不允许 NULL 且没传值，检查rules()是否漏了required，或数据库字段是否真设了NOT NULL
确认实际执行的 SQL 是什么
Yii2 的 AR 更新会生成 SQL，但你看到的报错可能来自中间某条语句，而非你写的那行 $model->save()。先拿到真实 SQL：
- 在更新前加一行：
echo $model->createCommand()->getRawSql();，注意：必须在save()之前调用，否则createCommand()会返回空 - 如果用了事务或批量更新，直接看日志更准：打开
runtime/logs/app.log，搜索UPDATE或INSERT，找紧挨着报错堆栈前的那条 SQL - 避免用
print_r($model->attributes)猜字段 —— 它不反映数据库约束，只反映当前对象状态
排查字段与约束是否匹配
很多报错表面是 SQL 错，根子在模型和 DB 表结构不一致：
- 运行
DESCRIBE user;（把user换成你的表名），逐项核对字段类型、是否允许 NULL、默认值 —— 尤其注意TINYINT(1)和BOOLEAN在 Yii2 里要映射为integer，写成string就会触发类型转换失败 - 检查
rules()里有没有漏掉必填字段，或用了'safe'却没在数据库设默认值 - 联合唯一索引（如
[['store_id', 'member_name'], 'unique']）报错时，错误码仍是1062，但提示里的key名可能是自动生成的（如store_id_member_name_unq），得去SHOW CREATE TABLE里确认真实索引名
绕过 AR 直接执行原生 SQL 验证
当不确定是 Yii2 框架问题还是 MySQL 层问题时，跳过框架直连验证：
- 复制上一步拿到的完整 SQL（含参数值，不是占位符），粘到 DBeaver / MySQL CLI 里执行 —— 如果还报错，就是纯数据库问题；如果不报错，说明 Yii2 构建 SQL 时做了隐式转换（比如把空字符串转成 NULL 插入
NOT NULL字段） - 特别注意时间字段：MySQL 严格模式下，
'0000-00-00'会被拒绝，而 Yii2 默认可能传这个值。用new \DateTime()或date('Y-m-d H:i:s')替代硬编码字符串 - 批量更新出错时，别只试第一条数据 —— 用
array_slice($data, 0, 1)取单条复现，排除数据集里某条脏数据导致全盘失败
最常被忽略的是：报错堆栈里第 3 行显示的是 BaseActiveRecord.php，但这不代表问题出在框架底层 —— 它只是执行入口，真正出事的 SQL 往往藏在第 1 行的 createCommand() 调用之后，或者在第 5 行你自定义的 beforeSave() 里悄悄改了属性值。
