database/sql 是接口规范层而非数据库驱动，实际操作委托给注册驱动；sql.Open 仅校验驱动名并返回未初始化的 *sql.DB，首次 Query 或 Ping 才触发驱动 Open 方法。
database/sql 包不是实际的数据库驱动
看到 database/sql 里一堆 Open、Query、Exec 就以为它在连数据库？错了。它只是个接口规范层，所有具体操作都委托给注册的驱动（比如 mysql、pq）。源码里几乎找不到网络调用或 SQL 解析逻辑，全是连接池管理、语句预编译缓存、sql.Rows 状态机封装这些“胶水代码”。
想定位真实执行位置，得顺着 driver.Conn 和 driver.Stmt 这两个接口往下查——它们才是驱动实现必须满足的契约。
-
sql.Open只做两件事：校验驱动名是否已注册、返回一个未初始化的*sql.DB - 第一次
db.Query或db.Ping才真正触发驱动的Open方法（由sql.openConnector调用） -
sql.Stmt的生命周期和底层驱动的driver.Stmt不完全一致：前者可复用，后者可能被驱动内部缓存或重建
从 sql.DB 的 Query 流程切入最有效
别一上来就翻 sql.go 全局函数，直接找 (*DB).Query 方法入口。它最终会走到 (*DB).queryDC → dc.query → dc.ci.Query，而 dc.ci 就是 driver.Conn 实例。这个调用链清晰展示了控制权如何移交到驱动层。
关键点在于 dc（*driverConn）：它是 sql.DB 内部连接池里的真实连接载体，包含锁、超时控制、重试逻辑，还负责把 context.Context 透传给驱动。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 连接获取走的是
db.conn方法，涉及空闲连接复用、新建连接、等待队列等逻辑，不是简单new -
dc.releaseConn不等于关闭连接，只是归还到空闲池；真正的 close 在dc.closeLocked里，且受db.maxLifetime影响 - 如果驱动返回
driver.ErrBadConn，database/sql会自动标记该连接为坏连接并尝试重试（最多一次），这个行为在dc.next中处理
注意 driver.Result 和 driver.Rows 的实现差异
driver.Result 是个极简接口：LastInsertId() 和 RowsAffected()。但很多驱动（如 lib/pq）对 LastInsertId 返回 errors.New("last insert id not supported") —— 这不是 bug，是设计使然，PostgreSQL 本身没标准自增 ID 概念。
driver.Rows 更值得细看：它的 Columns() 返回列名切片，Close() 必须释放资源，Next() 负责填充 dest 参数（类型为 []driver.Value）。这里容易踩坑的是 dest 元素的类型映射：
- MySQL 驱动把
TINYINT(1)当作bool，而 PostgreSQL 驱动默认当int8，导致 scan 失败 -
sql.Rows.Scan会把nil值转成 Go 的零值（如""、0），但前提是目标变量是指针或实现了Scanner接口 - 驱动返回的
driver.Value如果是[]byte，database/sql默认不拷贝，后续复用同一sql.Rows时可能被覆盖
调试时优先打 patch 而非读全量源码
Go 标准库的 database/sql 代码量不大（约 4000 行），但抽象层次多。与其逐行通读，不如在关键路径加日志：
比如在 dc.query 开头插入 fmt.Printf("query on conn %p: %s\n", dc, query)，再配合 go run -gcflags="-l" main.go 禁用内联，能快速确认哪条语句走了哪个连接、是否复用了预编译语句。
- 想验证连接池行为？改
db.SetMaxOpenConns(2)后并发发 5 个查询，观察dc.connect被调用几次 - 怀疑预编译失效？在
db.prepareDC里打印stmt.isPrepared和stmt.closed - 注意
sql.DB的字段基本都是 unexported，反射读取需用unsafe，生产环境慎用
真正难啃的部分不在 database/sql 本身，而在各驱动对 driver 接口的实现细节——比如 mysql 驱动的连接重试策略、pgx 对二进制协议的优化，那些才决定你应用的稳定性和性能边界。
