结论是必须将数据库驱动、客户端行为、sql方言三层拆开隔离：驱动用import _显式注册，客户端用接口封装，sql用迁移工具统一管理。因为go modules不支持同一模块多版本共存，驱动版本混用易致编译失败或panic，而数据库兼容性实际取决于sql语法和驱动api能力，非go.mod锁定的版本号。
直接说结论：别指望靠改 go.mod 或硬编码适配不同数据库版本，真正要做的，是把数据库驱动、客户端行为、SQL方言这三层拆开隔离——驱动用 import _ 显式注册，客户端用接口封装，SQL 用迁移工具统一管理。
为什么不能在 go.mod 里锁死多个数据库驱动版本
Go Modules 不支持同一模块路径（如 github.com/lib/pq）共存多个版本。你写两个 require 行指向不同 commit，go build 会自动合并为一个版本（通常是较新者），且不报错。更麻烦的是：github.com/jackc/pgx/v5 和 v4 是不同模块路径，但它们的 *pgxpool.Pool 类型不兼容，混用会导致编译失败或运行时 panic。
- 想同时支持 PostgreSQL v14 和 v15？别动驱动版本，v15 客户端通常向下兼容 v14 协议
- 想兼容 MySQL 5.7 和 8.0？重点不是驱动版本，而是 SQL 语法（比如
JSON_EXTRACT在 5.7 不支持->>操作符） -
go list -m all | grep pgx可查实际加载的驱动版本；go mod graph | grep pq能看出谁间接引入了老驱动
如何让同一套代码跑在 MySQL 5.7 / 8.0 和 PostgreSQL 14 / 15 上
核心是抽象出数据访问层接口，把数据库特异性逻辑收口到适配器里，而不是在业务代码里写 if db.Type == "mysql"。
- 定义统一接口，例如：
type Queryer interface { Query(ctx context.Context, sql string, args ...any) (Rows, error) } - 每个数据库实现自己的
MySQLQueryer和PGXQueryer，内部处理连接池初始化、错误码映射（如 MySQL 的ErrNoRowsvs PG 的pgx.ErrNoRows） - SQL 迁移文件按数据库分类存放：
migrations/mysql/20240520_add_user.up.sql、migrations/postgres/20240520_add_user.up.sql，用migrate.New加载对应 driver - 避免使用数据库专属函数：不用
IFNULL()（MySQL），改用标准COALESCE()；不用GENERATED ALWAYS AS（PG 12+），改用触发器或应用层计算
驱动注册和 DSN 配置最容易踩的坑
很多“连不上”问题根本不是网络或权限，而是驱动没注册或 DSN 格式错位。
- MySQL 驱动必须
import _ "github.com/go-sql-driver/mysql"，漏掉下划线 →sql.Open("mysql", dsn)返回nil+ “unknown driver” 错误 - PostgreSQL 的 DSN 中用户名含
@（如user@prod），必须用url.QueryEscape编码，否则解析失败且报错是pq: password authentication failed，极其误导 - SQLite 的 DSN 是文件路径，不能带
host=或port=，否则sql.Open静默返回空指针，首次查询才 panic - 所有 DSN 都要显式加时区参数：
?loc=Local（MySQL）、?timezone=Asia/Shanghai（PG），否则time.Time字段可能被转成 UTC 后丢小时
测试阶段怎么验证多数据库兼容性
光跑单元测试没用，得在真实驱动上跑集成测试，且不能共用连接池。
- 用
testcontainers-go启动临时 MySQL/PG 容器，每个测试用独立docker-compose.yml描述服务版本（如mysql:5.7、postgres:14-alpine） - 测试前先执行迁移：
migrate -path ./migrations/mysql -database "mysql://..." up，确保 schema 一致 - 避免在
TestMain里全局初始化 DB 实例——不同数据库测试会互相污染；每个TestXxx函数内调用setupDB(t, "mysql")独立建池 - 特别注意事务边界：MySQL 的
autocommit=off默认开启事务，PG 必须显式BEGIN；测试中别依赖“未提交就能被自己 SELECT 到”这种行为
最常被忽略的一点：数据库版本兼容性不是由 Go 代码决定的，而是由你写的 SQL 和你选的驱动 API 决定的。哪怕你用了最新版 pgx/v5，只要 SQL 里写了 CREATE TABLE ... USING btree（PG 15 才支持），在 PG 14 上照样报错。所以检查点永远要落在 SQL 层和驱动文档上，而不是 go.mod 里的版本号。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
