go-sql-driver/mysql 是 Go 官方推荐的纯 Go MySQL 驱动，实现 database/sql 接口，支持 TLS、多语句、时区控制及连接池精细管理，需配合 db.Ping() 验证连接、合理配置 DSN 与连接池参数。
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，大概率会拖垮数据库。
