gorm无法通过db.table()或db.session()切换数据库，因其不改变底层sql.db实例；正确做法是为每个库创建独立sql.db并缓存，请求时按租户id绑定。
不能靠 db.Table() 或 db.Session() 切换数据库，GORM 的“切换”本质是切换底层 *sql.DB 实例——每个库必须有独立连接池，且需在请求入口就完成绑定。
为什么 db.Use() 和 db.Session(&gorm.Session{}) 都不解决动态库切换
这两个方法只影响当前 *gorm.DB 实例的查询上下文（如命名空间、日志开关、事务隔离），不改变其持有的 *sql.DB 底层连接池。你调用 db.Session(...).First()，依然走的是初始化时 gorm.Open() 创建的那个库连接池。
-
db.Use()是插件注册，和数据库实例无关 -
db.Session()不会新建或替换*sql.DB，它只是克隆当前*gorm.DB并覆盖部分配置（比如Context、Logger） - 试图用
db.Exec("USE other_db")临时切库，在连接复用场景下极易串库——因为下一次从池里取出的连接可能刚执行过USE main_db
正确做法：按租户/分片 ID 缓存并复用 *sql.DB 实例
每个逻辑库（如 tenant_123、shard_us_east）对应一个独立 *sql.DB，由 sql.Open() 创建，并统一管理生命周期。
- 缓存用
sync.Map或带 TTL 的内存缓存（如gcache），避免高频建连 - DSN 拼接必须校验租户 ID：只允许字母、数字、下划线，长度 3–64，拒绝含
.、;、空格等危险字符 - 每个
*sql.DB单独调用SetMaxOpenConns(20)、SetConnMaxLifetime(1h)，防止配置互相污染 - 服务退出前遍历缓存，对每个
*sql.DB调用Close()
示例关键逻辑：
var dbCache sync.Map // string → *sql.DB
func GetTenantDB(tenantID string) (*sql.DB, error) {
if valid := regexp.MustCompile(`^[a-z][a-z0-9_]{2,63}$`).MatchString(tenantID); !valid {
return nil, fmt.Errorf("invalid tenant_id: %s", tenantID)
}
if db, ok := dbCache.Load(tenantID); ok {
return db.(*sql.DB), nil
}
dsn := fmt.Sprintf("user:pass@tcp(127.0.0.1:3306)/%s?parseTime=true", tenantID)
db, err := sql.Open("mysql", dsn)
if err != nil {
return nil, err
}
db.SetMaxOpenConns(20)
dbCache.Store(tenantID, db)
return db, nil
}
如何把动态 DB 注入 GORM 模型层
GORM 操作必须基于 *gorm.DB，而它需要一个 *sql.DB。所以拿到租户库后，要再包一层：
- 不要全局声明
var DB *gorm.DB，那只能指向一个库 - 在中间件中解析租户 ID（如从
X-Tenant-IDheader），调用GetTenantDB()，然后gorm.Open(mysql.Open(dsn), ...)创建新*gorm.DB - 把这个
*gorm.DB塞进context.Context，后续 handler 从 ctx 取，而不是用全局变量 - 模型方法如
User{}.Create()必须显式传入该*gorm.DB，不能依赖隐式全局实例
常见错误就是 handler 忘了从 ctx.Value() 取 DB，继续用错实例——这种 bug 很难测出来，直到数据写到别的租户库里才暴露。
最易被忽略的一点：跨租户事务绝对禁止。GORM 的 Transaction() 只作用于单个 *gorm.DB，而不同租户对应不同 *sql.DB，根本无法跨库开启分布式事务。业务上必须拆成最终一致性或本地事务+消息补偿。
