不能复用同一个*sql.db变量切换库，必须为每个数据源声明独立变量并显式设置连接池参数，驱动需编译期导入且名称大小写敏感，租户路由应通过sync.map缓存+上下文传递。
不能复用同一个 *sql.DB 变量切换库
Go 原生不支持运行时更换驱动或 DSN，强行用一个 *sql.DB 变量反复赋值（比如 db = sql.Open("mysql", dsn1) 再 db = sql.Open("postgres", dsn2)）会导致前一个连接池未关闭、连接泄漏、事务错乱，甚至 panic。
常见错误现象：
-
sql: connection refused或context deadline exceeded频发，实际是旧连接池还在尝试复用已失效的底层连接 - 事务提交后查不到数据，因为
db.Begin()创建的*sql.Tx绑定的是上一次初始化的连接池，而非当前目标库 - 日志里看到多个库的日志混在同一个连接池统计中，无法单独调优
正确做法是为每个数据源声明独立变量：
userDB, _ := sql.Open("mysql", dsnUser)
orderDB, _ := sql.Open("postgres", dsnOrder)
reportDB, _ := sql.Open("sqlite3", dsnReport)
别用全局 var db *sql.DB，也别在 init() 里隐式初始化——错误无法返回，启动失败难定位。
驱动必须编译期导入，不能运行时动态加载
database/sql 的驱动注册发生在包的 init() 函数，必须在 main 包编译时就引入对应驱动，否则 sql.Open("mysql", ...) 会 panic：sql: unknown driver "mysql"。
常见错误现象：
- 配置写了
driver: "postgres"，但程序启动报错说 driver 不存在——不是配置错，是没 import 驱动 - 用 flag 或配置文件判断是否启用 DM8，然后条件 import，结果编译不进二进制，运行时报错
实操建议：
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 所有可能用到的驱动都提前 blank-import，哪怕某些环境不用：
_ "github.com/go-sql-driver/mysql"、_ "github.com/lib/pq"、_ "gitee.com/chunanyong/dm" - 驱动名（
sql.Open第一个参数）必须与sql.Register()注册时一致，大小写敏感 - 不要试图用
plugin或反射加载驱动——Go 官方不支持，且破坏静态链接优势
多数据源必须各自配连接池参数
每个 *sql.DB 实例的连接池参数（SetMaxOpenConns、SetMaxIdleConns、SetConnMaxLifetime）互不影响，但必须显式设置。共用一套默认值或漏设，容易让某个库突发流量拖垮其他库，或连接耗尽后阻塞整个服务。
典型场景：
- 主库写压力大，需要
SetMaxOpenConns(100)；报表库只读、QPS 低，设成20更合理 - DM8 数据库连接空闲回收更慢，需设更大的
SetConnMaxLifetime，而 MySQL 默认值就够用 - 没调
SetMaxOpenConns，默认 0（无上限），数据库被撑爆
建议封装工厂函数统一管理：
func NewDB(cfg DBConfig) (*sql.DB, error) {
db, err := sql.Open(cfg.Driver, cfg.DSN)
if err != nil {
return nil, err
}
db.SetMaxOpenConns(cfg.MaxOpen)
db.SetMaxIdleConns(cfg.MaxIdle)
db.SetConnMaxLifetime(cfg.Lifetime)
return db, nil
}
租户/读写路由要用 sync.Map 缓存 + 显式上下文传递
HTTP 请求进来后，DB 实例选择必须在 handler 执行前完成，不能靠路径或 method “路由”，也不能 fallback 到全局变量。
容易踩的坑：
- 中间件里解析了
X-Tenant-ID并存入 context，但 handler 忘了从ctx.Value(tenantDBKey)取值，继续用错库 - 每次请求都重新
sql.Open，连接建立开销大、易超时 - 租户配置变更（如 DB 地址更新）后，缓存没清理，新连接仍走旧地址
推荐结构：
- 用
sync.Map缓存租户 ID →*sql.DB映射：tenantDBs.LoadOrStore(tenantID, newDB(cfg)) - 入口中间件校验租户标识并注入 context：
ctx = context.WithValue(ctx, tenantDBKey, db) - handler 中强制显式取值：
db := ctx.Value(tenantDBKey).(*sql.DB)，不提供 fallback - 读写分离不靠 SQL 解析，而是由业务标记意图：
ctx = context.WithValue(ctx, rwHintKey, "write")，再路由到主库
真正麻烦的从来不是“怎么切”，而是“怎么保证每次切都干净、可测、不残留”。连接池生命周期、驱动注册时机、上下文透传路径——这三个点漏掉任何一个，都会在压测或上线后突然爆发。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
