Go数据库驱动必须在main包init阶段通过空白导入完成注册，运行时无法动态加载；每个数据源需独立初始化*sql.DB实例并单独配置连接池；应使用注册表+工厂函数管理适配器，GORM v2需显式传Dialector而非驱动名。
驱动注册必须在 main 包 init 阶段完成
Go 的 database/sql 不自带任何驱动，所有驱动（如 mysql、postgres）都靠包的 init() 函数调用 sql.Register() 注册。这意味着你不能在运行时根据配置 import 驱动——它必须在编译期被包含进二进制。
常见错误是看到 sql: unknown driver "postgres" 就去改 DSN，其实只是漏了 blank-import：
-
import _ "github.com/lib/pq"（PostgreSQL） -
import _ "github.com/go-sql-driver/mysql"（MySQL） -
import _ "github.com/mattn/go-sqlite3"（SQLite）
所有可能用到的驱动，哪怕某些环境不用，也得提前写进 main.go。运行时无法加载新驱动，plugin 或 embed 都不支持。
每个数据源必须独立初始化 *sql.DB 实例
别试图用一个全局 var db *sql.DB 反复赋值切换库名或 DSN——前一个连接池不会关闭，连接持续泄漏，事务错乱、panic 是确定发生的。
立即学习“go语言免费学习笔记（深入）”；
正确做法是为每个数据源显式声明变量，并分别调用 sql.Open：
userDB, err := sql.Open("mysql", "user:pass@tcp(127.0.0.1:3306)/user_db?")logDB, err := sql.Open("postgres", "host=localhost dbname=log sslmode=disable")
即使 host/port 完全一样，仅 database 名不同（如 user_db 和 order_db），也必须走两套初始化流程。连接池参数（SetMaxOpenConns、SetConnMaxLifetime）必须按库单独设置，混用会导致雪崩。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
用注册表 + 工厂函数管理适配器实例
硬编码 if config.Driver == "mysql" 会随新数据源（如 ClickHouse、DM）迅速腐化。应建一个只读注册表，键为配置中声明的驱动名（如 "mysql"），值为构造对应 DBExecutor 的工厂函数。
示例结构：
- 定义接口：
type DBExecutor interface { Query(string, ...any) error } - 注册：
adapters["mysql"] = func() DBExecutor { return &MySQLAdapter{db: userDB} } - 使用：
exec := adapters[config.Driver]()，未注册则明确 panic，不静默 fallback
键名必须与配置项一致（大小写敏感），这样运维可通过 YAML 切换后端，无需改代码。适配器 struct 推荐显式字段（如 db *sql.DB），而非嵌入，避免透传无关方法破坏封装。
GORM v2 多数据源需显式传 Dialector，不能靠字符串驱动名
gorm.Open() 在 v2 中不再接受字符串驱动名，而是要求具体 Dialector 实例。配置里写 driver: "mysql" 没用，必须手动匹配：
-
import _ "gorm.io/driver/mysql"（驱动注册） userDB, _ := gorm.Open(mysql.Open(dsn1), &gorm.Config{})logDB, _ := gorm.Open(postgres.Open(dsn2), &gorm.Config{})
DSN 格式必须与驱动严格匹配：MySQL 驱动传 PostgreSQL 的 DSN，不会立刻报错，而是在首次查询时卡死或返回 "invalid connection"。PostgreSQL 用户名含 @ 必须用 url.QueryEscape 编码，否则报错信息极不明确。
最容易被忽略的是：GORM 的 Transaction() 只作用于调用它的那个实例，跨 *gorm.DB 实例的操作天然游离在事务之外。这不是封装能绕开的限制，得靠业务层补偿或 Saga 模式处理。
