gorm钩子未触发的主因是方法签名错误或接收者非指针，如beforecreate必须为*user接收者且首字母大写；save不触发beforecreate，批量操作可能跳过钩子；时间戳需用gorm:"autocreatetime"和json:"-"配合；关联数据应在主查询preload，钩子内不可调新查询；钩子返回error会中断操作并回滚事务。
为什么GORM钩子没触发？
GORM钩子（如BeforeCreate、AfterUpdate）不执行，最常见的原因是模型结构体没实现对应方法，或者方法签名不对——GORM只认特定签名的函数，且必须是**指针接收者**。比如func (u *User) BeforeCreate(tx *gorm.DB) error写成func (u User) BeforeCreate(...)或func (u *User) beforeCreate(...)，钩子就完全静默失效。
另外，GORM v2默认启用PrepareStmt（预编译），某些钩子在批量操作（如CreateInBatches）中可能被跳过；用Save代替Create时，BeforeCreate也不会调用——它只在插入新记录时触发。
- 钩子方法名必须全大写首字母，且严格匹配文档命名（
BeforeCreate≠Beforecreate） - 接收者必须为
*T，不能是T或**T - 返回
error类型，若返回非nil错误，整个操作会中断并回滚（在事务内） - 钩子内部不能直接调用
tx.Create等写操作，否则可能引发死循环或事务嵌套异常
如何让CreatedAt/UpdatedAt自动更新又不被JSON覆盖？
字段被前端传来的{"updated_at":"0001-01-01T00:00:00Z"}清零，本质是time.Time零值参与了UPDATE。GORM的时间戳行为由三要素共同控制：字段类型、struct tag、JSON tag。
正确写法是：CreatedAt time.Time `gorm:"autoCreateTime" json:"-"` + UpdatedAt time.Time `gorm:"autoUpdateTime" json:"-"`。关键点在于json:"-"彻底屏蔽JSON反序列化，同时gorm:"autoCreateTime"告诉GORM由它接管赋值。
- 别用
*time.Time加omitempty——前端传null仍会解包为nil指针，GORM不识别该语义 -
autoCreateTime:Nano可精确到纳秒，但MySQL 5.6+默认只支持秒级，需确认数据库精度 - 如果模型有
ID且前端传了值，GORM会当作UPDATE，CreatedAt钩子不会触发——此时应靠数据库DEFAULT CURRENT_TIMESTAMP保障
钩子里怎么安全访问关联数据？
在AfterFind里调用tx.Preload("Profile")会报错：钩子运行时事务上下文已结束，tx可能为nil或已提交。GORM钩子不提供延迟加载能力，Preload必须在主查询时显式声明。
真正可行的路径只有两条：一是把关联逻辑移到Handler里，用db.Preload("Profile").First(&user, id)；二是在钩子里只处理本表字段（比如拼接FullName），关联数据通过JOIN或子查询在SQL层解决。
-
AfterFind中tx不可用于新查询，但可用于修改当前实例字段（如u.StatusText = statusMap[u.Status]） - 想在
BeforeCreate里校验外键存在性？得用tx.First(&ref, u.RefID).Error == nil，但要注意这会增加一次DB round-trip - 避免在钩子里做HTTP请求、文件IO等阻塞操作——它运行在GORM事务上下文中，拖慢会影响整个DB连接池
事务内钩子失败会导致什么？
钩子返回error时，GORM会终止当前操作并标记事务为“需回滚”。但如果开发者手动调用了tx.Commit()，而钩子错误未被捕获，就会出现部分写入+无报错的脏数据状态。
最稳妥的做法是：所有带钩子的操作都包裹在db.Transaction(func(tx *gorm.DB) error { ... })中，并确保钩子错误能透出到事务闭包返回值。
- 不要依赖
defer tx.Rollback()——钩子错误发生后，事务状态已损坏，Rollback可能无效 -
Save和Updates触发的是BeforeUpdate/AfterUpdate，但UpdateColumn绕过所有钩子，慎用 - 测试钩子是否生效，最直接的方式是加
fmt.Printf打日志——GORM logger默认不打印钩子调用栈
