Go 数据库最佳实践是分层抽象：用标准 sql.DB/sql.Tx 作为契约，按业务定义窄接口，SQL 外置模板化管理，驱动注册与连接池配置分离，事务显式传递，方言差异用 build tag 处理。
Go 语言没有内置的数据库抽象层（如 Python 的 ORM 或 Java 的 JPA），直接用 database/sql 写业务容易重复造轮子、难以切换驱动、测试困难。真正的解法不是写个“万能 ORM”，而是分层控制抽象粒度：接口定义要窄，实现要松耦合，SQL 管理要显式可控。
用 database/sql 接口定义数据访问契约
别急着封装 Query/Exec 方法，先聚焦「什么该被抽象」。核心是让上层代码不依赖具体 driver（mysql、postgres、sqlite3），只依赖 Go 标准库的 sql.DB 和 sql.Tx —— 它们本身已是抽象接口。
常见错误是自定义一个 DataLayer 接口，把所有 SQL 操作都塞进去，结果导致 mock 成本高、职责过重。更务实的做法是按业务模块定义窄接口：
-
UserRepo只暴露GetByID(ctx, id)、Create(ctx, u)等语义化方法 - 每个方法内部用
*sql.DB或*sql.Tx执行具体 SQL，不暴露底层连接细节 - 接口不包含事务控制逻辑（如
BeginTx），由调用方决定是否传入*sql.Tx
SQL 文件管理 + text/template 避免字符串拼接
硬编码 SQL 字符串会导致可维护性差、无法静态检查、IDE 不支持语法高亮。推荐将 SQL 拆到独立文件（如 sql/user.sql），用 text/template 做简单参数占位，而非动态拼接表名或字段名。
示例：sql/user_get_by_id.sql
SELECT id, name, email FROM users WHERE id = ?
加载时用 embed.FS（Go 1.16+）或 os.ReadFile 读取，缓存为 map[string]string。关键点：
- 占位符统一用
?（适配大多数 driver），避免混用$1（Postgres）和:name（Oracle） - 不通过模板生成表名/列名——那是 SQL 注入温床，应在编译期确定
- SQL 文件路径建议按 domain 分组（
sql/user/、sql/order/），方便 IDE 查找
驱动注册与连接池配置必须显式分离
import _ "github.com/go-sql-driver/mysql" 这类隐式导入会让构建产物不可预测；而把 sql.Open 和连接池参数（SetMaxOpenConns 等）写死在 repo 初始化里，会导致测试难打桩、环境差异难收敛。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
正确做法是：
- 驱动导入放在
main.go或cmd/包下，确保只注册一次 - 数据库连接初始化交给专门的 factory 函数（如
NewDB(*Config) (*sql.DB, error)），接收完整配置结构体 - 连接池参数从环境变量或配置中心注入，不写死数值（例如
DB_MAX_OPEN_CONNS=20） - 测试时用
sqlmock替换*sql.DB，不启动真实数据库
事务传播靠参数传递，不依赖上下文或单例
试图用 context.WithValue(ctx, txKey, tx) 在中间件里透传事务，会导致调用链路不可见、panic 时回滚失败、goroutine 泄漏。Go 的并发模型决定了事务必须显式传递。
典型模式：
- 服务层开启
tx, err := db.BeginTx(ctx, nil) - 将
tx作为参数传给各 repo 方法（userRepo.Create(ctx, tx, u)） - 成功则
tx.Commit()，失败则tx.Rollback()（注意 defer 里要判 nil） - repo 层方法同时兼容
*sql.DB和*sql.Tx（二者都实现了QueryContext等方法）
这种写法看起来啰嗦，但换来的是清晰的控制流、可测试性、以及对 Go 并发模型的真实尊重——没人替你管好 goroutine 里的事务生命周期。
最常被忽略的是：SQL 方言差异（如 MySQL 的 INSERT IGNORE vs PostgreSQL 的 ON CONFLICT DO NOTHING）无法靠一层抽象抹平。遇到这类场景，要么接受特定驱动绑定，要么用 build tag 分离方言实现，别强行统一接口。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
