测试数据库初始化应避免在事务中执行DDL,正确做法是用testcontainers-go启动容器后建表或使用内存SQLite;数据清理优先用事务回滚而非DELETE;通过TestMain动态生成并设置TEST_DB_DSN环境变量;纯逻辑函数应依赖接口而非*sql.DB以支持mock。

测试数据库初始化时,别用 db.Exec("CREATE TABLE") 直接建表
很多测试一上来就 db.Exec("CREATE TABLE users (...)"),结果在 PostgreSQL 或 MySQL 中跑着跑着就失败——因为 DDL 语句(如 CREATE、DROP)会隐式提交当前事务,导致后续 tx.Rollback() 完全失效。
正确做法是:把表结构定义好,用 testcontainers-go 启动一个干净容器,在容器启动后一次性执行建表 SQL;或者更轻量地,用内存 SQLite(sqlite://:memory:),它天然支持 DDL + 事务隔离,无需额外清理。
- PostgreSQL/MySQL 测试中,初始化只做一次,在
TestMain里完成建表,之后所有测试复用同一套 schema - 如果必须动态建表(比如测试迁移逻辑),改用
sqlmock拦截并验证 DDL 执行顺序,不真连库 - 避免在每个
TestXXX函数里重复db.Exec,既慢又易错
数据清理别写 DELETE FROM users,优先用事务回滚
看到有人在每个测试末尾加 db.Exec("DELETE FROM users") 清空数据,这在多表、带外键、有索引的场景下极慢,还容易漏删关联记录(比如 user_profiles),导致下一个测试失败。
PostgreSQL 和 MySQL 都支持在测试开始时开启事务,全程操作走该事务,结束直接 tx.Rollback()。整个过程毫秒级,且 100% 隔离无副作用。
- 在
TestDBCreateUser开头写:tx, _ := db.Begin(),后面所有查询/插入都用tx.Query、tx.Exec - 结尾统一
tx.Rollback(),不用管表数量、外键或触发器 - 注意:不能在该事务内执行
CREATE TABLE等 DDL,否则回滚失效
集成测试前如何统一注入数据库连接字符串?
硬编码 "localhost:5432" 是测试脆弱的根源:本地端口被占、CI 环境没 DB、同事拉代码直接 panic。
推荐在 TestMain 里动态生成 DSN 并设为环境变量,测试函数只读取,不构造。
- 用
testcontainers-go启动容器后,拿到随机端口和密码,拼出完整 DSN - 调用
os.Setenv("TEST_DB_DSN", dsn),确保所有测试都能访问 - 测试函数里统一用
os.Getenv("TEST_DB_DSN")获取,不写死任何地址或凭证 - 这样本地开发、CI、Mac/Linux 差异全部被屏蔽,也不用改代码切环境
什么时候该跳过真实数据库?用接口 + mock 更快更稳
不是所有函数都需要连库——比如校验邮箱格式、拼接 WHERE 条件、转换时间戳,这些纯逻辑完全不该碰 DB。
把 DB 操作封装成接口(如 UserRepo),实现类叫 postgresUserRepo;测试时传入 mock 实现,只断言方法是否被调用、参数是否匹配、返回错误类型是否正确。
- 关键点:不要在 struct 里 embed
*sql.DB,而要依赖UserRepo这类接口 - 否则无法替换依赖,mock 成本陡增,甚至被迫启动真实 DB
-
sqlmock适合验证 SQL 语句本身(比如是否用了WHERE deleted_at IS NULL),但纯业务逻辑建议手写 mock 或用gomock
事务回滚看着简单,但 DDL 隐式提交、环境变量未生效、接口未抽象——这三个点,任何一个没踩准,测试就会从“秒级稳定”变成“随机失败”。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











