go中复用数据库连接应全局复用单个sql.db实例，避免重复sql.open；须配置setmaxopenconns、setmaxidleconns和setconnmaxlifetime，并在事务中使用sql.tx而非*sql.db执行操作。
go 里复用数据库连接不是“自己造池”，而是正确使用 sql.db 自带的连接池——只要不重复 sql.open、不手动关连接、参数设对，它天然就高性能。
为什么反复 sql.Open 是最常见错误
很多人在每个函数里写 db, _ := sql.Open("mysql", dsn)，结果压测时出现大量 too many connections 或 database is closed。这是因为：sql.Open 不建真实连接，只注册驱动和解析配置；每次调用都创建一个独立连接池，旧池子没被 Close() 就持续占着资源。
- 所有数据库操作应共享**同一个**
*sql.DB实例，全局声明或依赖注入 -
sql.Open只应在应用启动时调用一次，比如main()或init()中 - 别把
*sql.DB当成“连接对象”去传参、复制或临时 new —— 它是线程安全的池管理器，不是值类型
必须设置的三个关键参数
sql.DB 的默认参数适合本地开发，线上高并发场景下必须显式调优，否则连接数失控或空闲连接积压：
-
db.SetMaxOpenConns(20)：控制最多同时打开多少连接。建议 ≤ 数据库服务端max_connections× 0.8（MySQL 默认 151，所以 20～100 是常见值） -
db.SetMaxIdleConns(10)：空闲连接保留在池里的上限。一般设为MaxOpenConns / 2左右，太小导致频繁建连，太大浪费资源 -
db.SetConnMaxLifetime(60 * time.Second)：连接复用最长时间。推荐 30–60 秒，防止 DNS 变更或 DB 主动断开后连接卡死
注意：SetConnMaxLifetime 不是“连接存活多久就断”，而是“从创建起最多活这么久”，到期后下次归还池子时会被主动关闭。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
事务中别误用 db.Query
这是最容易引发隐性连接泄漏的点：事务必须用 *sql.Tx 对象上的方法，直接对 *sql.DB 调用 Query 或 Exec 会从池里另取一个连接，既破坏事务一致性，又让事务连接无法释放。
- ✅ 正确：
tx, _ := db.Begin(); tx.QueryRow("SELECT ...") - ❌ 错误：
tx, _ := db.Begin(); db.QueryRow("SELECT ...")（这个db.QueryRow拿的是新连接） - 事务结束后必须显式调用
tx.Commit()或tx.Rollback()，否则连接一直被占用
Ping 不等于健康，别拿它当连接池探活
db.Ping() 只检测当前能否拿到一个连接并执行一次简单语句，它不检查池中其他空闲连接是否有效。线上常有 ping 成功但后续 Query 随机失败的情况——本质是连接在归还池子时被 DB 主动断开了。
- 不要在 k8s readiness probe 里只用
db.Ping()，容易滚动更新时误判服务不可用 - 更可靠的健康检查应模拟业务路径，比如
db.QueryRow("SELECT 1").Scan(&i) - 若需自动剔除坏连接，可配合
db.SetConnMaxIdleTime(30 * time.Second)（Go 1.15+），让空闲太久的连接主动释放
真正决定复用效果的，从来不是“有没有池”，而是“池子怎么管”——参数是否贴合 DB 限制、事务是否走对对象、健康检查是否覆盖真实路径。这些细节漏掉一个，连接池就只是个摆设。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
