GORM模型钩子需满足特定条件才能触发：必须定义在模型同包、指针接收者、标准签名（如func (u *User) BeforeCreate(tx *gorm.DB) error），且v2仅对Create/Save/Delete/Update四类操作生效；软删除实际触发BeforeDelete和AfterUpdate而非AfterDelete；事务中Before返回error会回滚，After则不会。
gorm.Model 里哪些钩子函数能真正被触发
不是所有名字带 BeforeCreate 或 AfterDelete 的方法都会自动执行——GORM 只认特定签名、且必须定义在模型 struct 所属包内（不能是外部扩展类型）。最常踩的坑是：把钩子写在另一个文件里，或者给指针接收者写了值接收者方法，结果静默失效。
- 必须是
func (u *User) BeforeCreate(tx *gorm.DB) error这种签名，tx参数不能少，返回error也不能省 - 如果模型是嵌套结构或别名类型（比如
type Admin User），钩子不会继承，得单独为Admin实现 - GORM v2 默认只对
Create、Save、Delete、Update四类操作触发对应钩子；FirstOrInit、Find等查操作不触发任何钩子
BeforeUpdate 钩子里怎么安全修改字段而不引发循环
BeforeUpdate 容易误用成“自动更新时间”陷阱：直接赋值 u.UpdatedAt = time.Now() 后，GORM 会把整个 struct 当作待更新字段，可能覆盖掉你本意只想改一个字段的 Update("status", "done") 调用。
- 用
tx.Statement.SetColumn("updated_at", time.Now())替代直接赋值，它只影响 SQL 生成，不污染当前 struct - 如果要跳过某些字段更新（比如不想让
CreatedAt在 Update 时被覆盖），得配合Select()或Omit()显式控制字段范围 - 注意：在
BeforeUpdate里调用tx.Create()或其他写操作，会打断当前事务上下文，大概率导致死锁或数据不一致
软删除场景下钩子执行顺序和 DeletedAt 判断
启用软删除后，Delete 不再走 AfterDelete，而是走 BeforeDelete → 更新 DeletedAt → AfterUpdate。很多人卡在这儿，以为删了就该进 AfterDelete，结果日志没打、清理逻辑没跑。
- 软删除实际触发的是
BeforeDelete和AfterUpdate，不是AfterDelete - 在
BeforeDelete里可以通过tx.Statement.Dest拿到原始模型实例，但此时DeletedAt还是零值，不能靠它判断是否已软删 - 真要区分“硬删”和“软删”，得在钩子里检查
tx.Statement.Unscoped是否为 true，或者提前约定调用方式（比如硬删一定带Unscoped().Delete()）
事务中钩子失败会导致整个操作回滚吗
会，但仅限于返回非 nil error 的钩子。GORM 把钩子当作事务一部分处理，一旦 Before* 返回错误，后续 SQL 不发；After* 出错则事务已提交，只能靠补偿逻辑兜底。
立即学习“go语言免费学习笔记（深入）”；
-
BeforeCreate/BeforeUpdate返回 error → 整个操作终止，不进 DB -
AfterCreate/AfterUpdate返回 error → 数据已落库，钩子报错仅记录在 tx.Error 中，不会自动回滚 - 如果钩子里用了
tx.Session(&gorm.Session{NewDB: true})开新连接做异步通知，记得别传原tx进 goroutine，容易访问已释放的内存
钩子不是魔法，它只是方法调用时机的约定。最容易被忽略的是：跨 package 定义、接收者类型不匹配、以及软删除路径下钩子名的语义偏移——这些地方一错，就是静默失效，连日志都不打。
