go-sql-driver/mysql是 Go 语言中官方推荐、事实标准的 MySQL 驱动，它实现了 Go 标准库
database/sql所需的
driver.Driver接口，让你能用纯 Go（零 C 依赖）安全、跨平台地连接 MySQL、MariaDB、TiDB 等兼容数据库。
它不是 ORM，也不是封装层——它就是那个让
sql.Open("mysql", dsn) 能跑起来的底层驱动。所有基于 database/sql的操作（包括
sqlx、
gorm的底层连接）都靠它握手、认证、编解码、复用连接。
为什么必须用 go-sql-driver/mysql
，而不是别的？
Go 官方
database/sql本身不带任何数据库实现，必须靠第三方驱动注入能力。而
go-sql-driver/mysql是：
• 唯一被 Go 团队文档明确列为「MySQL 推荐驱动」的项目
• 纯 Go 实现，无 CGO，编译产物可直接部署到 Alpine、ARM64、Windows 等环境
• 支持 TLS、SCRAM-SHA-256、caching_sha2_password 等现代认证方式（
auth.go实现）
• 自动健康检查（
conncheck.go）、连接池生命周期管理（
SetConnMaxLifetime）和故障恢复逻辑
• benchmark 显示比同类驱动低约 40% 内存占用（来自
benchmark_test.go）
sql.Open
不等于“已连上”，db.Ping()
才是关键验证点
这是新手最常踩的坑：以为
sql.Open成功就万事大吉，结果后续查询报
dial tcp: i/o timeout或空指针 panic。
原因：
sql.Open只初始化连接池配置，不建真实 TCP 连接；真实连接是懒加载、按需获取的。
立即学习“go语言免费学习笔记（深入）”；
务必在sql.Open后调用
db.Ping()主动探活 若服务启动时 DB 尚未就绪，
db.Ping()会失败——这时应重试，而非 panic 生产环境建议加超时控制：
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
if err := db.PingContext(ctx); err != nil {
log.Fatal("failed to connect to DB:", err)
}
DSN 字符串里几个参数，直接影响时间解析、时区和批量执行
DSN 看似简单，但漏掉关键参数会导致诡异问题：
parseTime=true：否则
TIME/
DATETIME字段会被读成字符串，
time.Time字段 scan 失败
loc=Asia%2FShanghai：避免因系统默认时区（如 UTC）导致时间字段偏移 8 小时
multiStatements=true：启用后才支持
db.Exec("INSERT ...; UPDATE ...") 这种多语句，否则报错 Error 1146: Table 'xxx' doesn't exist（其实是第二条语句被跳过）
timeout=3s和
readTimeout=5s：控制连接建立与读取超时，防止 goroutine 卡死
一个生产可用的 DSN 示例：
root:pass@tcp(127.0.0.1:3306)/myapp?parseTime=true&loc=Asia%2FShanghai&multiStatements=true&timeout=3s&readTimeout=5s
连接池配置不设限，等于把 DB 当缓存用
sql.DB默认不限制连接数（
SetMaxOpenConns(0)），看似省心，实则危险：
• 高并发下可能瞬间打爆 MySQL 的
max_connections（默认通常 151）
• 空闲连接长期不释放，触发 MySQL 的
wait_timeout（默认 8 小时）后断连，后续请求报
invalid connection显式设置：
db.SetMaxOpenConns(20)（根据 DB 规格和业务 QPS 调整） 限制空闲连接：
db.SetMaxIdleConns(10)，避免连接堆积 强制回收老化连接：
db.SetConnMaxLifetime(60 * time.Second)，比 MySQL 的
wait_timeout短即可 注意：
SetConnMaxIdleTime（Go 1.15+）更精准控制空闲连接存活时间，建议优先使用
连接池参数不是配一次就完事——它得跟你的 DB 实例规格、QPS 曲线、事务平均耗时一起调。没压测就设
MaxOpenConns=100，大概率会拖垮数据库。
