BeforeCreate 和 BeforeUpdate 钩子没生效的常见原因包括：字段未导出（首字母小写）、缺少 GORM tag 或 embedded 声明、钩子签名错误、Session 启用了 SkipHooks；Gin 中需通过 context.Context 透传用户 ID 并在钩子中取值；Select/Omit 更新会跳过钩子，批量更新默认不触发钩子；time.Time 推荐配合 autoUpdateTime tag 使用，避免双重赋值。
为什么 BeforeCreate 和 BeforeUpdate 钩子没生效？
常见原因是结构体字段没有导出（首字母小写），或 GORM 未识别为模型字段。GORM 钩子只对被识别为模型字段的导出字段起作用，且必须满足：CreatedAt、UpdatedAt、DeletedAt 这类命名会被自动处理，但自定义审计字段（如 CreatedBy、UpdatedBy）必须手动在钩子里赋值，且字段需是导出的（大写开头）、有合法的 GORM tag（比如 gorm:"column:created_by"）。
实操建议：
- 确认结构体字段名首字母大写，例如
CreatedBy uint，不是createdBy uint - 检查是否漏了
gorm.Model嵌入或gorm:"embedded"—— 若用嵌入式审计结构，必须显式声明gorm:"embedded" - 钩子函数签名必须严格匹配：
func(*YourModel) error，返回error，不能是void或其他类型 - 如果用了
db.Session(&gorm.Session{SkipHooks: true})，钩子会被跳过 —— 检查业务代码中是否误启用了SkipHooks
如何在 Gin 中间件里注入当前用户 ID 到 GORM 钩子？
GORM 钩子本身不感知 HTTP 上下文，无法直接访问 Gin 的 c.Get("user_id")。必须把运行时信息“带进去”——最稳妥的方式是用 context.Context 透传，再通过 gorm.Session 绑定到本次 DB 操作。
实操建议：
- 在 Gin 中间件中，把用户 ID 写入请求上下文：
c.Set("user_id", userID)，然后用c.Request = c.Request.WithContext(context.WithValue(c.Request.Context(), "user_id", userID)) - 在钩子函数中，**不能直接访问 Gin Context**，而应改用 GORM 的
Session：在调用db.Create()前，先db.Session(&gorm.Session{Context: c.Request.Context()}) - 钩子函数内通过
model.Context.Value("user_id")取值（注意判空），再赋给model.CreatedBy等字段 - 避免用全局变量或闭包捕获用户 ID —— 并发下会错乱
BeforeUpdate 钩子为何只更新部分字段时失效？
使用 db.Select("name").Updates(&u) 或 db.Omit("updated_at").Save(&u) 时，GORM 默认跳过所有钩子（包括 BeforeUpdate），除非显式启用：db.Session(&gorm.Session{FullSaveAssociations: true}) 不起作用，真正有效的是 db.Session(&gorm.Session{AllowGlobalUpdate: false}) 之外的另一个开关：db.Session(&gorm.Session{Context: ctx}).Select("name").Updates(&u) 仍会触发钩子，但仅当模型本身实现了 BeforeUpdate 且未被 Omit 排除字段时才执行。
实操建议：
- 若依赖
BeforeUpdate自动更新UpdatedAt和UpdatedBy，**禁止使用Omit("updated_at", "updated_by")**，否则字段不会被设值 - 批量更新（
db.Model(&User{}).Where(...).Updates(...)）默认不触发任何钩子 —— 必须改用单条Create/Save，或手动在业务层补全审计字段 - 测试时用
db.DryRun查看实际生成的 SQL，确认updated_by是否出现在 SET 子句中
时间字段用 time.Time 还是 int64？
用 time.Time 更自然，但要注意时区和精度问题；用 int64（秒级时间戳）能规避时区，但 GORM 不会自动调用 time.Now().Unix()，仍需在钩子里手动赋值。
实操建议：
- 推荐统一用
time.Time，配合gorm:"autoUpdateTime:milli"tag 让 GORM 自动维护UpdatedAt（毫秒级），但自定义字段如CreatedAt仍需钩子 - 如果数据库是 MySQL 5.6 且未启用
explicit_defaults_for_timestamp，time.Time字段可能被默认设为0000-00-00 00:00:00—— 此时应在 struct tag 加gorm:"default:current_timestamp" - 避免在钩子里写
model.CreatedAt = time.Now().UTC()后又让 GORM 自动填充 —— 双重赋值易导致测试难 mock，应只留一种来源
钩子逻辑看似简单，但跨中间件、跨 Session、跨 Update 模式时容易断链；最常被忽略的是：钩子函数里的错误被静默吞掉（GORM 默认不 panic），建议在钩子里加日志，至少输出 model.ID 和 CreatedBy 值，方便定位哪次操作漏填了审计字段。
