每个数据库必须使用独立的*gorm.DB实例,复用同一变量会导致事务失效、连接池错乱、日志和回调污染;需分别调用gorm.Open初始化,并单独配置连接池、中间件与迁移。

不能靠改一个 *gorm.DB 变量来“切换”数据库——每个库必须是独立的 *gorm.DB 实例,否则事务失效、连接池错乱、日志和回调互相污染。
为什么 gorm.Open 不能复用同一个变量
GORM 的 *gorm.DB 不是轻量上下文,它内部封装了 *sql.DB、回调链(Callbacks)、日志器(Logger)、插件(如 prometheus、opentelemetry)和连接池配置。两个不同 DSN 的数据库,哪怕只是库名不同,也必须调用两次 gorm.Open,分别赋值给不同变量(如 userDB、logDB)。
- 复用同一变量(比如
db = gorm.Open()覆盖赋值)会导致前一个库的连接池未关闭,连接泄漏 - 事务只在单个
*gorm.DB内有效:userDB.Transaction()中调用logDB.Create(),后者完全游离在事务外 - 驱动导入漏下划线(
import _ "gorm.io/driver/mysql"缺少_)时,gorm.Open不报错,但首次查询卡死或返回"invalid connection"
如何安全注册多个 GORM 实例
启动时显式初始化,避免 init() 隐式加载;每个实例用唯一变量名,并单独配置连接池与中间件。
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。
- 用工厂函数替代全局
var:例如NewUserDB(cfg) (*gorm.DB, error),错误可透出、便于测试 - DSN 特殊字符必须编码:PostgreSQL 密码含
/或@时,需用url.QueryEscape处理,否则报"pq: password authentication failed"且难以定位 - 每个
*gorm.DB单独加中间件:userDB.Use(logger.New()),别用gorm.DefaultCallback全局注册,否则所有库共享同一日志行为 - 模型迁移必须按库执行:
userDB.AutoMigrate(&User{})和logDB.AutoMigrate(&Log{})是两套独立操作
运行时动态路由到对应 *gorm.DB 实例
靠 context.Context 透传目标库标识,由统一路由层(非 ORM 层)解析并返回对应 *gorm.DB,禁止在 DAO 层硬编码 if tenant == "shanghai" { return userDB } 等分支逻辑。
- 租户识别必须在入口中间件完成:从
r.Host、r.Header.Get("X-Tenant-ID")或 JWT claim 提取,查主库确认存在后才继续 - 缓存用
sync.Map或带 TTL 的内存缓存(如gcache),key 是租户 ID,value 是已Ping()验证过的*gorm.DB - handler 中必须显式取值:
db := ctx.Value(tenantDBKey).(*gorm.DB),而不是根据条件判断该用哪个变量
最易被忽略的是连接池参数的隔离——SetMaxOpenConns、SetMaxIdleConns 必须对每个 *gorm.DB 单独调用,且要从 db.Session(&gorm.Session{}).DB() 获取底层 *sql.DB 后再设。漏掉这步,某个分片库突发流量可能耗尽整个进程的连接资源。










