多个*sql.DB实例必须独立初始化，不能复用变量；Go原生不支持运行时切换DSN或driver，复用会导致事务错乱、连接泄漏甚至panic；正确做法是为每个数据源声明语义明确的独立变量并单独配置连接池参数。
多个*sql.DB实例必须独立初始化，不能复用变量
Go 原生不支持在运行时切换 *sql.DB 底层的 DSN 或 driver，强行用同一个变量反复调用 sql.Open 或执行 USE db_name 会引发事务错乱、连接泄漏，甚至 panic。真实错误现象包括：事务提交后数据未写入、database/sql 报 sql: transaction has already been committed or rolled back、连接池耗尽后请求卡死。
正确做法是为每个数据源显式声明独立变量：
userDB, err := sql.Open("mysql", cfg.UserDB.DSN)orderDB, err := sql.Open("mysql", cfg.OrderDB.DSN)- 变量名需语义明确（如
userDB、logDB），禁止使用db1、db2等模糊命名 - 每个实例必须单独调用
SetMaxOpenConns()、SetMaxIdleConns()、SetConnMaxLifetime()—— 支付库连接数宜保守（如 10–20），报表库可设高些（如 80+）
YAML 配置要扁平化，避免嵌套导致解析歧义
把 host、user、password 拆成顶层字段，再拼接 DSN，容易因空格、特殊字符或环境变量注入顺序出错；而深层嵌套（如 mysql.databases.user.host）会让结构体绑定和配置校验变复杂。
推荐一级 key 直接对应数据源名称：
立即学习“go语言免费学习笔记（深入）”；
mysql:
user_db:
dsn: "${USER_DB_USER}:${USER_DB_PASS}@tcp(10.0.1.10:3306)/user_center?charset=utf8mb4&parseTime=True"
max_open_conns: 20
max_idle_conns: 10
order_db:
dsn: "${ORDER_DB_USER}:${ORDER_DB_PASS}@tcp(10.0.1.11:3306)/order_service?charset=utf8mb4&parseTime=True"
max_open_conns: 50
max_idle_conns: 20
注意：& 是 YAML 字符串中的字面量，不是 HTML 实体；解析后直接传给 sql.Open 即可，无需额外 decode。
别在 init() 里初始化数据库，改用工厂函数
func init() 中初始化 *sql.DB 会导致错误无法透出、启动失败难定位——比如 DSN 写错或网络不通，服务静默失败，日志里只有一行 panic: runtime error，没有上下文。
应封装为显式工厂函数：
func NewUserDB(cfg Config) (*sql.DB, error)func NewOrderDB(cfg Config) (*sql.DB, error)- 函数内立即调用
db.PingContext(context.Background())验证连通性 - 错误必须返回，不 fallback、不重试、不静默忽略
这样既能控制初始化时机，又便于单元测试 mock 返回值。
租户场景下用 sync.Map 缓存按需加载，而非启动时全量初始化
SaaS 类多租户系统若在服务启动时就把所有租户的 *sql.DB 全部初始化，会极大拖慢启动速度，且浪费连接资源——多数租户可能长期不活跃。
正确策略是延迟加载 + 缓存：
- 定义全局
var tenantDBs = sync.Map{}，key 为租户 ID（string），value 为*sql.DB - 中间件中从
r.Header.Get("X-Tenant-ID")提取标识，先查主库确认租户有效性，再查tenantDBs - 首次访问某租户时，才调用
sql.Open初始化对应实例，并设置专属连接池参数 - 后续请求直接复用缓存实例，避免重复建连
这个模式下，连接池参数可以按租户级别差异化配置，比如 VIP 租户连接数上限更高，小客户则更保守——这是硬编码单例完全做不到的。
最容易被忽略的一点是：事务永远无法跨 *sql.DB 实例生效。你在 userDB.BeginTx() 里调用 logDB.Exec()，后者完全游离在事务之外。所有跨库写操作，必须设计为最终一致性，靠消息队列或对账机制兜底，而不是幻想“统一事务”。
