动态表名与事务必须结合使用：先开启事务，再在事务内调用tx.Table()指定表名；白名单校验不可省略，Scopes不能封装Table()，多表操作需确保结构一致且DeletedAt字段统一。
动态表名 + 事务不能混用 db.Table() 和 db.Transaction() 直接链式调用——因为 Table() 返回的是新会话上下文，而事务对象是独立的 *gorm.DB 实例，二者作用域不重叠。必须先开启事务，再在事务内调用 Table()。
动态表名必须在事务内部调用 Table()
事务中切换表名，核心是：事务句柄（*gorm.DB）本身要作为 Table() 的调用主体，而不是在事务外构造好带 Table() 的查询再塞进事务里。
- ❌ 错误写法：先
db.Table("logs_202409").Create()得到一个带表名的查询，再传给db.Transaction()—— 这时Table()绑定的是原始非事务 DB，事务里实际执行的仍是默认表名 - ✅ 正确写法：在
Transaction()的闭包里，对传入的事务tx调用tx.Table("...").Create() - 白名单校验仍需保留，否则攻击者可通过控制时间格式注入非法表名，比如
logs_;DROP TABLE users--
func archiveWithTx(db *gorm.DB, entry LogEntry) error {
yearMonth := time.Now().Format("200601")
tableName := "logs_" + yearMonth
if !regexp.MustCompile(`^logs_\d{6}$`).MatchString(tableName) {
return errors.New("invalid archive table name")
}
return db.Transaction(func(tx *gorm.DB) error {
// ✅ 在 tx 上调用 Table()
if err := tx.Table(tableName).Create(&entry).Error; err != nil {
return err
}
// 可继续在同一事务里操作其他表，如更新主表计数器
return tx.Model(&LogCounter{}).Where("month", yearMonth).Update("count", gorm.Expr("count + 1")).Error
})
}
Scopes 不能直接封装 Table() 调用
Scopes() 的设计目标是复用 WHERE/ORDER/OFFSET 等查询条件，它不改变语句的“目标表”这一元信息；Table() 是模型级元数据覆盖，必须在查询链最前端或紧邻 Model() 使用，和 Scopes() 的执行时机不兼容。
- ❌
func WithArchiveTable() func(*gorm.DB) *gorm.DB { return func(db *gorm.DB) *gorm.DB { return db.Table("...") } }—— 无效：该函数返回的 DB 不会被后续Scopes()链识别为“已指定表”，且若前面有Model(&Log{})，Table()会被覆盖 - ✅ 动态表名逻辑应前置：在进入
Scopes()前，先根据业务参数确定表名，再用db.Table(name).Scopes(...) - 如果多个地方都要按月归档，建议封装成工厂函数：
NewArchiveDB(db *gorm.DB, month string) *gorm.DB，内部做白名单+Table()，再返回可链式调用的 DB 实例
事务内多表操作时，Table() 和 Model() 混用要小心
同一个事务里操作不同归档表（如 logs_202409 和 logs_202410），不能依赖单个 Model() 结构体来回切换——Model() 只影响字段映射和钩子触发，但不会自动适配不同表结构。
- 若两张归档表结构完全一致（推荐做法），可用同一结构体，仅靠
Table()切换：tx.Table("logs_202409").Create(&e1); tx.Table("logs_202410").Create(&e2) - 若结构有差异（如某月加了字段），必须用对应结构体 + 显式
Table()，否则 GORM 会按原结构体映射，导致 INSERT 字段缺失或报错 - 软删除字段
DeletedAt必须在所有归档表中存在且类型一致，否则Create()可能静默忽略该字段，或触发 NOT NULL 约束失败
真正容易被忽略的点是：事务回滚时，Table() 切换过的表名不会自动还原——它只是当前查询链的状态，不影响事务对象本身。所以只要每次都在事务闭包内显式调用 tx.Table(xxx)，就不存在“表名残留”问题；但如果你在事务外误用了 db.Table() 并复用这个 DB 实例，那后续所有操作都会跑偏。
