sql.Open仅初始化连接池而不校验连通性，真实错误在db.Ping或db.Query时暴露；需立即调用db.Ping验证，正确配置DSN参数（parseTime=true、loc=Asia/Shanghai）、连接池（SetMaxOpenConns等）及事务终态处理。
Go 连 MySQL 不是“装个驱动就能用”，关键在 sql.Open 只是初始化连接池，不校验数据库连通性——很多 panic 其实发生在第一次 db.Query 或 db.Ping 时才暴露。
为什么 sql.Open 不报错，但后续操作却连不上？
这是最常被误解的一点：sql.Open 只解析 DSN、配置连接池参数，并不真正拨号。它返回的 *sql.DB 是一个连接池句柄，真正的网络握手延迟到第一次需要获取连接时（比如 db.Ping()、db.Query()）。
常见错误现象：
- 代码编译通过、
sql.Open返回nilerror，但一执行查询就 panic：driver: bad connection或dial tcp: i/o timeout - 本地能连，部署到容器后报
connection refused（其实是 DNS 解析失败或端口未映射）
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 务必在
sql.Open后立即调用db.Ping()并检查 error，这才是真实连通性验证 - DSN 中不要硬编码密码，改用
url.QueryEscape处理含特殊字符的密码（如@、/） - 使用
parseTime=true&loc=Local参数避免 time.Time 解析失败（否则 MySQL 的DATETIME可能转成零值）
github.com/go-sql-driver/mysql 的 DSN 格式与关键参数
官方驱动的 DSN 不是标准 URL，格式为：user:password@tcp(127.0.0.1:3306)/dbname?param=value。漏掉 tcp(...) 或写成 mysql://... 都会直接 panic。
必须显式设置的关键参数：
-
parseTime=true：让驱动把 MySQL 时间字段解析为time.Time（否则是[]byte） -
loc=Asia/Shanghai（或loc=Local）：避免时区错乱（MySQL 默认用系统时区，Go 默认 UTC） -
timeout=5s和readTimeout=10s：防止慢查询拖垮整个服务 -
multiStatements=true：仅当真要执行多语句（如SELECT 1; SELECT 2;）才开，否则有 SQL 注入风险
示例 DSN：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
user:pass@tcp(192.168.1.100:3306)/myapp?parseTime=true&loc=Asia%2FShanghai&timeout=3s
连接池配置不当导致的超时和泄漏
*sql.DB 自带连接池，但默认配置极宽松：MaxOpenConns=0（无限制）、MaxIdleConns=2、ConnMaxLifetime=0（永不过期）。高并发下容易打满 MySQL 连接数，或复用过期连接引发 invalid connection。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 显式调用
db.SetMaxOpenConns(20)和db.SetMaxIdleConns(10)，数值按压测结果调整（通常 Open ≤ Idle × 2） - 设
db.SetConnMaxLifetime(60 * time.Second)：强制连接在 60 秒后重建，避开 MySQL 的wait_timeout（默认 8 小时，但云数据库常缩到 300 秒） - 不要在函数内反复
sql.Open——*sql.DB是线程安全、应全局复用的单例 - 应用退出前调用
db.Close()，否则进程可能 hang 住（等待空闲连接归还）
事务中忘记 Rollback 或 Commit 的隐蔽问题
Go 的 tx, err := db.Begin() 后，如果只做 tx.Query 却没调 tx.Commit() 或 tx.Rollback()，该连接会一直被占用在事务中，直到超时释放——这会导致连接池缓慢耗尽，且错误日志里只显示 context deadline exceeded，很难定位。
推荐写法（用 defer + 匿名函数保底）：
tx, err := db.Begin()
if err != nil {
return err
}
defer func() {
if p := recover(); p != nil {
tx.Rollback()
panic(p)
}
}()
if _, err := tx.Exec("INSERT ..."); err != nil {
tx.Rollback()
return err
}
return tx.Commit()更稳妥的是用 sqlx 或封装事务辅助函数，确保每个 Begin 都对应明确的终态。
时区、连接池生命周期、事务收尾——这三个地方不细看文档，线上跑一周都未必出问题，一出就是凌晨两点的连接数告警。
