sql.open仅初始化连接池且不建立真实连接，必须立即调用db.ping()验证连通性；dsn需含parsetime=true和loc=utc，驱动须匿名导入，连接池参数须通过setmaxopenconns等方法显式设置。
sql.Open 不等于连上数据库，必须调用 db.Ping()
绝大多数人以为 sql.Open 成功就代表数据库通了，其实它只校验 DSN 格式和驱动注册状态，不发任何网络包。MySQL 服务宕机、密码错误、端口被封——这些全都不会在 sql.Open 阶段暴露。
真正建连发生在第一次 db.Query、db.Exec 或显式调用 db.Ping() 时。线上服务若跳过 db.Ping()，第一个请求就会 panic，且错误堆栈藏在业务逻辑里，排查成本陡增。
- 初始化后立刻加
if err := db.Ping(); err != nil { log.Fatal("failed to connect to MySQL:", err) } - 不要把
db.Ping()放进 HTTP handler，它应是启动期一次性健康检查 - 如果用容器部署，可在 readiness probe 中复用同一
db.Ping()逻辑
DSN 必须带 parseTime=true 和 loc=Local（或 loc=UTC）
MySQL 的 DATETIME 字段默认以字符串形式返回，不启用 parseTime=true，Scan 到 time.Time 会直接报错：sql: Scan error on column index 0, name "created_at": unsupported Scan, storing driver.Value type []uint8 into type *time.Time。
loc=Local 表示用 Go 进程所在机器的本地时区解析时间；生产环境更推荐 loc=UTC + 应用层统一转换，避免多台服务器时区不一致导致日志/统计错乱。
- DSN 示例：
"user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=true&loc=UTC" - 注意 URL 编码：& 必须写成
&（HTML 环境下），代码中直接拼字符串则用& -
parseTime=true大小写敏感，parsetime=true无效
驱动导入必须用 _ 匿名导入，否则报 unknown driver "mysql"
Go 的 database/sql 是接口层，github.com/go-sql-driver/mysql 才是实现。驱动靠 init() 函数向 sql 包注册自己，而这个注册动作只在包被导入时触发。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
如果只写 import "github.com/go-sql-driver/mysql"，编译器发现没用到该包的任何符号，可能直接优化掉；必须用匿名导入 import _ "github.com/go-sql-driver/mysql" 强制执行 init()。
- 错误写法：
import "database/sql"; import "github.com/go-sql-driver/mysql"→ 运行时报sql: unknown driver "mysql" - 正确写法：
import "database/sql"; import _ "github.com/go-sql-driver/mysql" - 别试图“简化”为单行 import —— Go 不支持 import 别名用于驱动注册
连接池参数不能靠 DSN 配置，必须调用 db.SetXXX 方法
很多人误以为在 DSN 里加 maxOpen=25 就能控制连接数，实际上 go-sql-driver/mysql 完全忽略这类参数。所有连接池行为都由 *sql.DB 实例上的方法控制。
不设限会导致 MySQL 报 ERROR 1040 (HY000): Too many connections；设得太死又会在高并发下排队阻塞。关键参数有三个：
-
db.SetMaxOpenConns(25)：同时打开的最大连接数（含正在用和空闲的） -
db.SetMaxIdleConns(25)：空闲连接池上限，设太小会频繁新建连接 -
db.SetConnMaxLifetime(5 * time.Minute)：连接最大存活时间，防止被 MySQL 的wait_timeout主动断开
云数据库（如阿里云 RDS、AWS RDS）通常把 wait_timeout 设得比默认值（28800 秒）短得多，SetConnMaxLifetime 是刚需，不是可选项。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
