钩子函数在gorm中于crud操作的固定生命周期节点触发，如beforecreate仅在db.create()且主键未设置时执行，afterfind则每次查询赋值后均执行。
钩子函数在GORM中什么时候被触发
GORM的钩子（Callbacks）不是“注册后自动运行”的监听器，而是嵌入在CRUD生命周期里的固定执行点。比如 BeforeCreate 只在调用 db.Create() 且记录未设置主键时触发；AfterFind 则每次从数据库查出数据、赋值到结构体后都执行——哪怕你用 db.First()、db.Find() 或关联预加载（Preload）都会进。
容易踩的坑：Save() 是个特例：它会根据记录是否有主键值，内部自动选择 Create 或 Update 流程，因此触发的是 BeforeCreate 或 BeforeUpdate，而不是某个叫 BeforeSave 的钩子（GORM v2 没有这个钩子）。
如何定义和注册自定义钩子
钩子函数必须是结构体方法，接收指针 receiver，并返回 error。不能是普通函数或闭包。
- 方法签名必须为
func (u *User) BeforeCreate(tx *gorm.DB) error—— 第二个参数是*gorm.DB，不是context.Context或其他 - 注册方式只有两种：全局注册（
schema.RegisterCallback）或模型级注册（func(*gorm.DB) *gorm.DB的Callback().Create().Before("gorm:create")） - 全局注册影响所有模型，慎用；推荐在模型的
SetupModel或TableName方法附近集中注册
示例：
func (u *User) BeforeCreate(tx *gorm.DB) error {
u.CreatedAt = time.Now()
u.Status = "active"
return nil
}
钩子中访问和修改数据的注意事项
钩子内拿到的 tx 是当前操作的事务对象，但此时记录尚未写入数据库，所以 tx.Statement.ReflectValue 指向的是你传入的结构体实例——直接改字段即可，GORM 会在后续 SQL 中使用新值。
但要注意：
-
tx.Create(&u)进钩子时，u.ID若为 0，BeforeCreate才会触发；若已设非零 ID，则走Update流程 - 在
AfterFind中修改字段，不会自动回写数据库；如需保存，得显式调用tx.Save()，否则只是内存变更 - 不要在钩子里调用
tx.First()等查询再嵌套触发钩子——可能造成无限递归或事务死锁
常见错误：钩子不执行的几个典型原因
最常遇到的不是语法错，而是流程没走对：
- 用了
db.Model(&u).Updates(map[string]interface{}{"name": "x"})—— 这种 map 更新绕过结构体反射，BeforeUpdate不触发（只会触发BeforeUpdateStmt这类语句级钩子） - 结构体字段没导出（小写开头），GORM 无法反射读写，钩子中对该字段的读写都静默失败
- 钩子方法定义在匿名嵌入结构体里，而没在主结构体上声明，GORM 不识别
- GORM v2 默认禁用部分钩子（如
AfterDelete在软删除模型中默认不触发），需手动启用：db.Callback().Delete().After("gorm:delete").Register("my_after_delete", yourFunc)
钩子不是魔法，它严格绑定 GORM 内部的方法调度链；跳过标准入口（比如直接拼 SQL 或用 Raw()），钩子就彻底失效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
