AfterUpdate钩子未触发最常见的原因是方法签名错误或定义位置不当：必须用指针接收者、单个*gorm.DB参数、error返回值，且与模型同包；Save()默认走BeforeSave/AfterSave，Updates()需显式启用钩子；事务中未提交则钩子不执行。
AfterUpdate钩子为什么没被触发
最常见的原因是模型结构体没实现 AfterUpdate 方法，或者方法签名不对。GORM 要求该方法必须是 func(*YourModel) error 类型，且必须定义在指针接收器上。如果写成值接收器、返回非 error 类型、或参数不是单个指针，GORM 就会静默忽略它。
另外，Save() 和 Updates() 行为不同：前者会走完整生命周期（含钩子），后者默认跳过钩子——除非显式启用：db.Session(&gorm.Session{SkipHooks: false}).Model(&u).Updates(map[string]interface{}{"name": "new"})。
- 确认方法名拼写严格为
AfterUpdate（大小写敏感） - 检查是否在事务中更新但未提交——钩子在 Commit 后才执行
- 避免在钩子里调用
Save()或其他可能触发递归钩子的操作
审计日志字段怎么安全获取旧值和新值
GORM 的 AfterUpdate 钩子只提供新状态的模型实例，不直接暴露旧值。想记录“从 A 改为 B”，得自己查库或借助 BeforeUpdate 缓存。
推荐做法是在 BeforeUpdate 中把当前数据库值暂存到模型字段（如 oldName），然后在 AfterUpdate 中对比使用。注意这些临时字段不能映射到数据库（加 gorm:"-" 标签），否则会干扰主表结构。
func (u *User) BeforeUpdate(tx *gorm.DB) error {
if u.ID > 0 {
var old User
tx.First(&old, u.ID)
u.oldName = old.Name
}
return nil
}
func (u *User) AfterUpdate(tx *gorm.DB) error {
log.Printf("User %d updated name from '%s' to '%s'", u.ID, u.oldName, u.Name)
return nil
}
审计日志写入失败会不会影响主事务
会。GORM 钩子运行在同一个事务上下文中，如果 AfterUpdate 返回 error，整个事务将回滚——这通常不是你想要的，审计失败不该导致业务更新失败。
解决办法是让钩子本身不返回错误，而是异步或降级处理日志：
- 用 goroutine 异步写日志（注意模型数据逃逸风险，需深拷贝）
- 写入失败时仅打 error 日志，不 return error
- 更稳妥的做法：把审计逻辑抽离到事务外，比如监听
db.Statement.Dest+db.Statement.ChangedDBValues，在Save后手动补日志
用 Session 控制钩子开关的典型场景
有些批量更新（如后台定时任务）不需要审计，而用户操作必须记。这时别改模型代码，用 Session 动态控制：
// 需要审计：默认行为即可
db.Save(&user)
// 不需要审计：跳过所有钩子
db.Session(&gorm.Session{SkipHooks: true}).Save(&user)
// 只跳过某些钩子（GORM v1.25+）：
db.Session(&gorm.Session{Context: context.WithValue(ctx, "skip_audit", true)}).Save(&user)
然后在 AfterUpdate 里判断上下文：if ctx.Value("skip_audit") == true { return nil }。这种灵活性比硬编码更可控。
钩子本身不感知事务边界以外的状态，所以跨服务、跨数据库的审计动作，得靠外部消息队列或 CDC 工具补位——别指望单个 AfterUpdate 包打天下。
