根本原因是Go的database/sql要求驱动必须通过import _ "xxx"触发init()注册，GORM仅封装该机制；若未正确导入（如pgx需\_ "github.com/jackc/pgx/v5/stdlib"）或DriverName与sql.Register名不一致，就会报“unknown driver”。
为什么 gorm.Open 传自定义驱动名会报 “driver: unknown driver”
根本原因不是 GORM 拒绝自定义，而是 Go 的 database/sql 机制要求：驱动必须被显式导入并触发 init() 函数注册。GORM 只是封装了这一层，它不负责注册驱动本身。
常见错误是只改了 DriverName 字段，却没在 import 块里加对应驱动的匿名导入（即带下划线的 _ "xxx"）。比如用 pgx 却只导入 "github.com/jackc/pgx/v5" 而非 _ "github.com/jackc/pgx/v5/pgxpool" 或官方推荐的 _ "github.com/jackc/pgx/v5/stdlib" —— 后者才真正调用 sql.Register。
- MySQL 自定义驱动：必须
_ "example.com/my_mysql_driver"，且该包的init()里要调用sql.Register("my_mysql_driver", &MySQLDriver{}) - PostgreSQL 自定义驱动：推荐用
pgx/v5/stdlib，它把 pgx 包装成标准sql.Driver，再通过_ "github.com/jackc/pgx/v5/stdlib"注册为"pgx" - 别漏掉
import顺序：自定义驱动导入语句必须在"gorm.io/gorm"和"gorm.io/driver/mysql"（或其他官方驱动）之前，否则可能被覆盖
mysql.New 和 postgres.New 的 DriverName 参数怎么用
这个字段不是让你“起个新名字”，而是告诉 GORM：底层用哪个已注册的 sql.Driver 名字去拨号。它必须和 sql.Register 时传的第一个参数完全一致。
例如你用 pgx/stdlib，它内部注册的是 sql.Register("pgx", ...)，那你就得写 DriverName: "pgx"；如果用 lib/pq，它注册的是 "postgres"，那就不能写成 "pq"。
- MySQL 官方驱动默认注册名为
"mysql"，所以mysql.New(...)内部默认用DriverName: "mysql" - 想换自定义 MySQL 驱动？先确保它注册了
"my_custom_mysql"，再写mysql.New(mysql.Config{DriverName: "my_custom_mysql", DSN: "..."}) - PostgreSQL 场景下，
postgres.New(postgres.Config{DriverName: "pgx", DSN: "..."})才能真正走 pgx 协议；写成"postgres"就回落到lib/pq
自定义驱动后，DSN 格式还和原来一样吗
完全取决于你导入的那个驱动本身支持什么格式 —— GORM 不做解析、不改写、不兼容。它只是把 DSN 字符串原样传给 sql.Open(DriverName, DSN)。
这意味着：哪怕你用 mysql.New 构造器，只要 DriverName 指向的是另一个驱动，DSN 就必须符合那个驱动的要求。比如 myql_native_password 插件驱动可能要求 ?authPlugin=...&timeout=...，而标准 go-sql-driver/mysql 不认这些参数，直接 panic。
- 查文档看驱动支持的 DSN key：pgx 支持
min_connections、max_connections；lib/pq 不支持，写了就忽略 - 时间相关参数如
parseTime、loc是 MySQL 驱动特有，PG 驱动不识别，硬加会导致连接失败 - 本地开发连 PostgreSQL 时，
sslmode=disable是lib/pq和pgx/stdlib都要求的；漏掉就会卡住或报server does not support SSL
怎么验证自定义驱动真的生效了
不能只看 gorm.Open 是否返回 err == nil，因为那只是配置加载成功。真正要确认驱动行为，得观察运行时表现。
最直接的方法是查连接池底层类型：比如用 pgx，执行 db.Config.ConnPool.(*pgxpool.Pool) 能成功断言，说明连的是 pgx；如果 panic 说类型不匹配，大概率还是走的 lib/pq。
- 打印驱动名：
db.Statement.ConnPool.Stats().MaxOpenConnections看不到 pgx 特有的字段？说明没生效 - 抓包验证协议：用
tcpdump或 Wireshark 看实际握手是 MySQL 协议还是 PostgreSQL 的 StartupMessage - 故意写错 DSN 中驱动专属参数：比如给 pgx DSN 加
parseTime=True，如果报错提示“unknown parameter”，说明驱动确实是 pgx；如果静默忽略，说明实际走的是 lib/pq
自定义驱动最容易被绕过的环节，是 import 路径拼错、init 未触发、或者 DriverName 字符串大小写/下划线不一致 —— 这些细节不打日志、不报错，但驱动就是不动声色地 fallback 到默认实现。
