最稳妥方式是先用findOne()查出模型、修改后调用save()持久化。需检查返回值是否为null，save()失败时查看getErrors()；批量简单更新可用updateAll()但须校验影响行数；涉及多操作或关联表时应包裹事务。
Yii2 中用 ActiveRecord::findOne() 查找并修改单条记录
直接改数据库单条记录，最稳妥的方式是先查出来、再改、再保存。Yii2 的 ActiveRecord 天然支持这个流程，关键不是“怎么写 SQL”，而是“怎么让模型正确加载、验证、持久化”。findOne() 是最常用的查找入口，它返回一个已实例化的模型对象，后续所有修改都在内存中进行，最后调用 save() 才真正写入数据库。
常见错误是跳过查找、直接 new 一个空模型然后赋值 ID 和字段——这会导致验证失败（比如非空字段没设）、事件不触发（如 beforeSave）、脏检查失效（save() 可能跳过更新）。
-
findOne()接收主键值（如123）、主键数组（如['id' => 123]）或条件数组（如['status' => 'pending']），但后者需确保只命中一条，否则只取第一条 - 修改后调用
save()，它会自动判断是 INSERT 还是 UPDATE；若想强制 UPDATE（跳过 INSERT 分支），可用update()静态方法（见下节） - 如果字段不允许为空或有自定义验证规则，
save()会返回false，此时应检查$model->getErrors()
$user = \app\models\User::findOne(1001);
if ($user !== null) {
$user->name = '张三';
$user->status = 2;
if (!$user->save()) {
\Yii::error($user->getErrors());
}
}
用 ActiveRecord::updateAll() 绕过模型验证批量更新单条（慎用）
当明确只要改几个字段、且不需要触发模型生命周期（如验证、事件、关系处理）时，可以用 updateAll() 直接发 UPDATE SQL。它不加载模型，不走验证，性能略高，但风险也高：字段类型错、约束冲突、逻辑遗漏都得自己兜底。
典型适用场景：后台运营工具里“一键启用/禁用某用户”，字段简单、无业务逻辑耦合。
- 第一个参数是待更新的字段数组，如
['status' => 1, 'updated_at' => time()] - 第二个参数是 WHERE 条件，必须包含主键或强唯一条件，否则可能误更新多条（如写成
['status' => 0]就很危险） - 返回值是影响行数（int），可用于判断是否真有记录被改；若为 0，说明没匹配到数据
- 注意时间字段要手动赋值，不会自动填充
updatedAt行为
$affected = \app\models\User::updateAll(
['status' => 1, 'updated_at' => time()],
['id' => 1001]
);
if ($affected === 0) {
// 记录不存在
}
修改前检查记录是否存在，避免 save() 报错或静默失败
findOne() 返回 null 表示查不到，但很多人忽略这个判断，直接调用 save()，结果报 Calling save() on a null object 或更隐蔽的 PHP Warning。更麻烦的是，用 updateAll() 时返回 0 却不处理，导致前端以为操作成功，实际数据没变。
- 永远对
findOne()的返回值做!== null判断，不要只用if ($model)（空字符串、0 等也会被转为 false） - 用
updateAll()后检查返回值是否为 0，并区分“无匹配”和“匹配但字段值未变”（MySQL 的ROW_COUNT()在值不变时不计数） - 如果业务上“记录必须存在”，建议抛出
\yii\web\NotFoundHttpException，比静默失败更利于定位问题
事务包裹修改操作，防止部分成功导致数据不一致
单条记录看似简单，但若修改涉及关联表（如同时更新用户表和用户配置表），或后续还有其他 DB 操作，就必须加事务。Yii 默认不开启事务，save() 和 updateAll() 都是独立执行的。
- 用
\Yii::$app->db->transaction()包裹多个操作，异常时自动回滚 - 即使只改一条记录，只要后续有缓存更新、日志写入等副作用操作，也建议套事务，保证 DB 和外部状态一致
- 注意事务嵌套：Yii 不支持原生嵌套事务，重复调用
transaction()会报错，需用try/catch显式控制
return \Yii::$app->db->transaction(function ($db) use ($userId) {
$user = \app\models\User::findOne($userId);
if (!$user || !$user->save()) {
throw new \Exception('User update failed');
}
// 其他操作...
return true;
});
真实项目里，最常被跳过的其实是“查出来之后是否真的需要验证”——有些字段改完立刻生效（如开关类），有些则牵一发而动全身（如用户名变更要同步消息系统）。选 findOne()+save() 还是 updateAll()，本质是在安全性和可控性之间做权衡，而不是看哪段代码更短。
