Go数据库配置需正确注册驱动、校验DSN格式、设置连接池参数、用PingContext验证连接，并通过环境变量安全管理DSN。
Go 里没有“数据库环境配置”这个抽象概念，只有具体驱动的连接字符串、连接池参数和初始化逻辑——直接配错 sql.Open 的第一个参数（驱动名）或第二个参数（DSN），连接就根本不会建立。
确认驱动已注册且 DSN 格式正确
Go 的 database/sql 是接口层，必须显式导入并触发驱动的 init() 函数。比如用 PostgreSQL，得导入 _ "github.com/lib/pq"（下划线表示只执行初始化），而不是 "github.com/lib/pq"。
DSN 格式由驱动定义，不是统一标准：
- MySQL（
github.com/go-sql-driver/mysql）：user:password@tcp(127.0.0.1:3306)/dbname?parseTime=true&loc=Local - PostgreSQL（
github.com/lib/pq）：host=localhost port=5432 user=myuser password=mypass dbname=mydb sslmode=disable - SQLite（
github.com/mattn/go-sqlite3）：./app.db?_busy_timeout=5000
常见错误：漏掉 sslmode=disable 导致 PostgreSQL 连接卡死；MySQL 中把 & 写成 &（HTML 实体）导致解析失败；路径含空格没加引号（SQLite 场景）。
立即学习“go语言免费学习笔记（深入）”；
设置连接池参数避免资源耗尽
sql.DB 本身不是单个连接，而是连接池的句柄。不调 SetMaxOpenConns、SetMaxIdleConns、SetConnMaxLifetime，线上服务容易因连接堆积或复用过期连接而报错。
典型配置建议：
hdhcms网站支持PC、手机版，同时后台支持公众号的接入，包括微信服务号订阅号，可以设置自动回复及服务号菜单及认证订阅号菜单。 1、网站上线方法： 1.1本网站运行环境为：IIS6.5+SQLITE 1.2将网站解压到网站目录 1.3数据库默认为SQLITE，包括在解压目录内，无须修改 1.4 完成上面的配置后通过所绑定的域名即可运行2网址访问及后台访问配置
-
db.SetMaxOpenConns(25)：防止突发流量打爆数据库（MySQL 默认最大连接数常为 151） -
db.SetMaxIdleConns(25)：避免频繁建连/断连，但别设太高（如 100），否则空闲连接长期占着 DB 资源 -
db.SetConnMaxLifetime(5 * time.Minute)：强制回收可能被中间件（如 RDS 代理、防火墙）静默断开的老连接
注意：SetConnMaxLifetime 不是连接有效期倒计时，而是“连接创建后最多活多久”，超时后下次复用时会被关闭重建。
用 db.PingContext 主动验证连接有效性
sql.Open 只校验 DSN 语法，不真正连数据库。db.Ping() 或更安全的 db.PingContext(ctx) 才会发起一次握手。它应该在服务启动时执行，而非每次查询前调用。
示例片段：
if err := db.PingContext(context.Background()); err != nil {
log.Fatal("failed to connect to database:", err)
}
若使用容器部署，还要考虑启动顺序：DB 容器可能比 Go 服务慢几秒就绪。此时应加简单重试（如 3 次，间隔 1s），而不是让服务直接 crash。
区分开发/生产环境的 DSN 来源
不要硬编码 DSN。优先从环境变量读取：
- 开发：用
os.Getenv("DB_DSN")，配合.env文件（用godotenv加载） - 生产：通过 Kubernetes Secret、Docker --env 或系统级环境变量注入
关键点：DSN 中的密码绝不能出现在代码或 Git 历史中。如果用配置文件（如 YAML），确保其不被提交，且权限设为 600。另外，postgres:// 类 URL 形式虽简洁，但某些驱动（如 lib/pq）对特殊字符（如密码含 @ 或 /）解析不稳定，建议拆解为键值对形式。
