go中数据库驱动必须用下划线导入（如import _ "github.com/lib/pq"）以触发init注册，否则sql.open会panic；dsn格式因驱动而异，需严格按文档书写；sql.open不校验连接，必须调db.ping()；连接池参数须显式设置，且须在首次使用前完成。
驱动导入必须用下划线，不能直接调用包名
Go 的 database/sql 是纯接口层，不带任何数据库实现。如果你只写 import "github.com/lib/pq"，sql.Open("postgres", dsn) 会 panic 报错：sql: unknown driver "postgres"。根本原因是驱动没注册——它的 init() 函数没被执行。
正确做法是下划线导入：import _ "github.com/lib/pq"。这个下划线表示“只执行初始化，不引入标识符”。MySQL、SQLite、金仓（gokb）、Oracle（go-oci8）全部遵循这一规则。
常见踩坑点：
- 误写成
import "github.com/lib/pq"（少了下划线），编译不报错，运行时才炸 - 在子包里导入驱动但 main 包没导入，导致驱动未注册（驱动注册是全局的，必须在启动路径上）
- 用
go mod vendor后忘了把驱动包 vendor 进来，CI 环境跑不通
DSN 格式由驱动定义，不是通用标准
不同驱动对连接字符串（DSN）的语法要求差异很大，拼错一个字符就连接失败，且错误信息往往模糊（比如卡住、timeout、invalid URL escape）。不能靠“差不多”去试。
PostgreSQL（lib/pq）必须显式声明 SSL 模式：host=localhost port=5432 user=app password=123 dbname=mydb sslmode=disable。漏掉 sslmode=disable 在本地开发常卡死，因为默认尝试 SSL 握手，而你的 PostgreSQL 可能没开 SSL。
MySQL（go-sql-driver/mysql）要用 URL 风格：user:pass@tcp(127.0.0.1:3306)/dbname?parseTime=true&loc=Local。注意两点：一是 & 是 HTML 实体，代码里得写成 &；二是密码含 @ 或 / 时，必须用 url.QueryEscape 编码，否则解析失败。
金仓（gokb）和 Oracle（go-oci8）的 DSN 更特殊：前者接近 PostgreSQL 格式但参数名不同（如 service_name 替代 dbname）；后者依赖 ORACLE_HOME 和 LD_LIBRARY_PATH，DSN 本身只是用户名/密码/地址，底层连通性由环境变量决定。
sql.Open 不校验连接，db.Ping() 才是第一道防线
sql.Open 只是初始化连接池结构并返回 *sql.DB，哪怕你传了 host=xxx.invalid port=9999，它也完全不报错。很多服务上线后第一次查库才崩，根源就在这儿。
必须在初始化后立刻调用 db.Ping() 或更安全的 db.PingContext(ctx)（支持超时控制）。它会同步发起一次轻量握手，真实检测网络、认证、权限是否就绪。
容易忽略的细节：
- 没加
ctx.WithTimeout，PingContext可能无限等待（尤其 DNS 解析失败或防火墙拦截时） - 在 Kubernetes 中，
Ping()成功不代表后续查询一定成功——可能因 readiness probe 过早通过，DB 还没加载完 schema - 某些驱动（如
go-oci8）首次Ping会触发 OCI 客户端初始化，耗时明显，别放在热路径里反复调
连接池参数不设等于自毁，线上必须显式配置
*sql.DB 默认的连接池行为极其危险：SetMaxOpenConns(0)（无上限）、SetMaxIdleConns(0)（空闲连接数不限）、SetConnMaxLifetime(0)（连接永不过期）。这在高并发或长事务场景下，必然导致数据库连接数打满、TIME_WAIT 堆积、stale connection 报 connection reset by peer。
生产环境最低限度要设三参数：
-
db.SetMaxOpenConns(25)：建议设为数据库max_connections的 70%～80%，MySQL 默认 151，PostgreSQL 常设 100，那就取 70～80 -
db.SetMaxIdleConns(10)：必须 ≤MaxOpenConns，否则空闲连接无法回收；值太大（如 50）会让 DB 端长期挂着一堆 idle 连接 -
db.SetConnMaxLifetime(30 * time.Minute)：不是倒计时，而是“连接创建后最多活这么久”，防止被 RDS 代理、云防火墙静默断连
最隐蔽的问题是：这些参数必须在 sql.Open 之后、首次使用前设置。如果先执行了 db.Query，连接池已预热，再调 SetMaxOpenConns 就只影响后续新建连接，旧连接仍不受控。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
