数据库连接池初始化必须在main()开始时完成，需调用sql.Open和db.Ping验证，并设MaxOpen/IdleConns；DSN必须含charset=utf8mb4；推荐sqlx或gorm封装；测试须用独立实例或sqlmock。
数据库连接池初始化必须在 main() 开始时完成
Go 的 sql.DB 本身不是单个连接，而是连接池的抽象。延迟初始化（比如在 handler 里首次调用才 sql.Open）会导致并发请求触发多次重复初始化，可能创建多个独立池、泄露资源，或因未设超时引发启动卡死。
实操建议：
- 在
main()函数最开始调用database/sql.Open，并立即调用db.Ping()验证连通性 - 用
db.SetMaxOpenConns和db.SetMaxIdleConns显式设值（默认 0 表示无限制，线上极易耗尽数据库连接） - 把
*sql.DB实例作为全局变量或依赖注入进 handler，避免跨包重复 open - 不要在 init() 里做
sql.Open—— 无法返回 error，失败时静默 panic
MySQL DSN 中 charset=utf8mb4 是硬性要求
不显式指定 charset=utf8mb4，Go 默认用 utf8（实际是 utf8mb3），会导致 emoji、部分生僻汉字写入被截断或报错 Incorrect string value，且错误发生在 Exec/Query 阶段，而非连接阶段，极难排查。
正确 DSN 示例："user:pass@tcp(127.0.0.1:3306)/dbname?parseTime=true&loc=Asia%2FShanghai&charset=utf8mb4"
注意点：
立即学习“go语言免费学习笔记（深入）”；
使用约定式提交（Conventional Commits）从 Git 历史记录中生成结构化变更日志，支持多种格式、AI 增强型描述以及可自定义的范围……
-
parseTime=true让time.Time能直接 Scan 进 struct 字段，否则需手动转换 -
loc=Asia%2FShanghai避免时区错位（MySQL server time zone ≠ Go 运行时 zone） - 密码含特殊字符（如 @ / :）必须 URL 编码，否则 DSN 解析失败
用 sqlx 或 gorm 替代原生 database/sql 做初始化封装
原生 database/sql 初始化后还需手写大量 Scan、StructScan、命名参数映射逻辑，容易出错且难以维护。sqlx 提供轻量增强，gorm 更适合需要自动迁移和复杂关联的项目。
推荐做法：
- 小项目/内部工具：用
sqlx.Connect替代sql.Open，支持结构体自动绑定和命名参数（:name） - 中大型业务：用
gorm.Open(gorm.MySQL(...), ...)，初始化时传入&gorm.Config{PrepareStmt: true}开启预编译防 SQL 注入 - 无论选哪个，都应在初始化后统一调用
db.Exec("SELECT 1")或执行一条空事务验证连接有效性
测试环境必须用独立数据库实例或 schema，不能共用开发库
本地跑 go test 时若直连开发库，测试中的 DELETE、DROP TABLE 或并发写入会污染数据，甚至导致开发环境功能异常。更隐蔽的问题是：测试用 db.Close() 后，其他测试再用同一全局 *sql.DB 会 panic 报 sql: database is closed。
安全方案：
- 测试前用
testdb.NewTestDB()（或类似封装）起一个临时 MySQL 容器（docker run -e MYSQL_ALLOW_EMPTY_PASSWORD=yes ...），测试完自动销毁 - 或使用
github.com/DATA-DOG/go-sqlmock模拟 driver，完全绕过真实数据库 - 禁止在
init()或TestMain外部初始化全局 DB 变量；测试用 DB 必须在每个 TestXxx 函数内单独 setup/teardown
真正麻烦的不是连不上数据库，而是连上了却用错了字符集、开多了连接、或者测试把开发库删了——这些都不会在 go build 时报错。
