Golang database/sql标准库怎么用_Golang数据库操作基础_网络技术

发布时间 - 2026-01-30 00:00:00 点击率：次

database/sql 是接口规范，需搭配驱动使用；sql.Open 不建连，须用 db.Ping() 校验；Query 用于多行需手动 Close，QueryRow 用于单行自动关闭；防注入须用占位符；事务须配对 Commit/Rollback；连接池参数需调优。

直接用 database/sql 无法执行任何数据库操作——它只是接口规范，必须搭配驱动（如 github.com/go-sql-driver/mysql 或 github.com/lib/pq）才能工作。

sql.Open 只是初始化连接池配置，并不真正建连。真实校验要靠 db.Ping()。

常见错误现象：sql.Open 返回 nil error，但后续 Query 报 "sql: database is closed" 或超时
正确做法：初始化后立刻调用 db.Ping() 并检查 error
注意：db.Ping() 是同步阻塞的，生产环境建议加 context 控制超时，例如 db.PingContext(ctx, time.Second*5)

本质是结果集数量预期不同，影响资源释放逻辑和 panic 风险。

Query 用于多行结果（如 SELECT 多条记录），返回 *sql.Rows，必须显式调用 rows.Close()，否则连接不会归还池中
QueryRow 用于单行结果（如 SELECT ... LIMIT 1 或聚合函数），内部自动 close，但若实际无结果会返回 sql.ErrNoRows，不处理就 panic
别用 QueryRow 去查可能返回多行的数据——它只读第一行，其余被丢弃且不报错

永远用 ? 占位符 + 参数列表，不要字符串拼接。

立即学习“go语言免费学习笔记（深入）”；

连接会一直被事务占用，直到超时或进程退出，最终拖垮连接池。

典型陷阱：只写了 tx.Commit()，但没在 defer 或 else 分支里配对 tx.Rollback()
推荐模式：defer func() { if r := recover(); r != nil { tx.Rollback() } }() + 显式 i f err != nil { tx.Rollback(); return }
更稳妥的做法：用 tx, err := db.BeginTx(ctx, &sql.TxOptions{Isolation: sql.LevelReadCommitted})，支持 context 取消

最易被忽略的是连接池行为：默认 MaxOpenConns=0（无限制）、MaxIdleConns=2，高并发下很容易耗尽数据库连接数。上线前务必根据 DB 实例规格调优这两个值。