beforeUpdate 不是 Yii2 ActiveRecord 的内置事件，真实可用的更新相关事件只有 beforeSave（$insert === false 时）和 afterSave；所有更新前逻辑必须放在 beforeSave 中判断 $insert，且 updateAll() 完全绕过模型生命周期。
Yii2 的 beforeUpdate 事件根本不存在
直接说结论：beforeUpdate 不是 Yii2 ActiveRecord 的内置事件，也不会被 save() 或任何标准方法触发。你在文档、IDE 提示或调试器里都找不到它——因为框架源码里没定义这个常量，ActiveRecord 类也不在更新前 emit 它。
常见错误现象是：在模型里写 $this->on('beforeUpdate', ...)，然后发现断点从不进入；或者看到别人代码里写了 EVENT_BEFORE_UPDATE，但运行时完全没响应。
真实可用的更新相关事件只有两个：
-
beforeSave($insert)：当$insert === false时，代表本次是更新操作 -
afterSave($insert, $changedAttributes)：同样靠$insert判断是否为更新
注意：EVENT_BEFORE_UPDATE 确实存在于某些第三方扩展或老版本兼容层中，但官方核心（截至 2026 年）从未将其纳入 ActiveRecord 生命周期。别被 IDE 自动补全或过时博客误导。
beforeSave 是更新逻辑的唯一入口
所有需要在更新前执行的逻辑（比如校验关联状态、清理冗余字段、生成摘要），必须放在 beforeSave() 里，并显式判断 $insert 参数。
典型用法：
public function beforeSave($insert)
{
if (parent::beforeSave($insert)) {
if (!$insert) { // ← 关键判断：仅更新时执行
$this->updated_at = time();
if ($this->isAttributeChanged('status')) {
$this->status_updated_at = time();
}
}
return true;
}
return false;
}
容易踩的坑：
- 忘记调用
parent::beforeSave($insert)，导致验证跳过或时间戳行为失效 - 在
rules()中把updated_at设为required，导致validate()失败、save()直接返回false，beforeSave根本不执行 - 在事务中修改属性后，又手动调用
$model->save(false)（跳过验证），此时beforeSave仍会触发，但beforeValidate不会
批量更新（updateAll()）不走 beforeSave
如果你调用的是 User::updateAll(['status' => 2], ['id' => $ids])，整个过程绕过模型实例，beforeSave、afterSave、验证、行为、软删除条件全部失效。
这时候想“模拟 beforeUpdate”逻辑，只能：
- 改用循环 + 单条
findOne()->save()（适合数据量小、需强一致性） - 在 DAO 层用
createCommand()->update()手动拼 SQL，并在 SQL 里处理时间戳等字段（如updated_at = UNIX_TIMESTAMP()） - 用数据库触发器（不推荐，业务逻辑下沉难维护）
性能影响明显：100 条记录用单条 save() 会发 100 次查询+事务开销；而 updateAll() 是 1 次查询，快一个数量级。
想复用更新前逻辑？优先用 Behavior 而非硬编码
如果多个模型都需要自动更新 updated_at、记录操作人、或做字段标准化，不要每个模型都重写 beforeSave。
正确做法是定义行为：
class AutoUpdateBehavior extends Behavior
{
public $updatedAtAttribute = 'updated_at';
public function events()
{
return [ActiveRecord::EVENT_BEFORE_UPDATE => 'updateTimestamp'];
}
public function updateTimestamp($event)
{
if ($this->owner->hasAttribute($this->updatedAtAttribute)) {
$this->owner->{$this->updatedAtAttribute} = time();
}
}
}
然后在模型中声明：
public function behaviors()
{
return [
'autoUpdate' => AutoUpdateBehavior::className(),
];
}
注意：EVENT_BEFORE_UPDATE 这里只是 Behavior 内部自定义的事件名，和框架无关——它实际是靠 Behavior 在 beforeSave 里手动触发的。真正的触发点仍是 beforeSave，只是封装了一层。
复杂点在于：Behavior 的 events() 返回的键必须是 ActiveRecord 支持的真实事件（如 ActiveRecord::EVENT_BEFORE_INSERT），不能写 'beforeUpdate' 字符串——否则注册无效。
