直连真实数据库会导致单元测试失败，因环境不可控：数据库未启动、权限不足、表结构不一致、数据污染；且启动慢、难覆盖边界场景、sql语法不兼容。
为什么直接用真实数据库跑GORM单元测试会失败
GORM单元测试如果直连本地MySQL或PostgreSQL，常出现connection refused、database doesn't exist或并发写冲突。根本原因不是代码写错，而是测试环境不可控：数据库未启动、权限不足、表结构不一致、其他测试用例污染数据。
- 测试应隔离运行，每次执行前无残留状态
- 真实DB启动慢，拖累CI流水线（单测耗时从毫秒级升至秒级）
- 无法覆盖“查询返回空”“主键冲突”“外键约束失败”等边界场景
用内存数据库（如sqlite）虽快，但SQL语法和行为与生产库不一致，比如MySQL的INSERT IGNORE在SQLite里不生效，容易埋下兼容性坑。
用gorm.io/gorm/mock替代真实DB连接
GORM官方不提供Mock工具，但社区广泛采用gorm.io/gorm自带的gorm.Session + 内存模型 + 接口抽象来绕过DB层。核心思路是：把DAO逻辑抽成接口，测试时注入Mock实现。
- 定义仓储接口，例如：
type UserRepository interface { Create(<em>User) error; FindByID(uint) (</em>User, error) } - 生产代码用
GormDB.Create()实现该接口；测试代码用纯Go结构体+map模拟行为 - 避免直接在测试里调
db.Create()，否则Mock失效
示例片段：
// Mock实现
type MockUserRepo struct {
users map[uint]*User
}
func (m *MockUserRepo) Create(u *User) error {
if u.ID == 0 { u.ID = 1 } // 模拟自增
m.users[u.ID] = u
return nil
}
这样能精准控制返回值，比如让FindByID(999)返回nil, errors.New("not found")。
测试事务回滚与关联操作的关键点
GORM的db.Transaction()和Preload()在Mock中极易漏测。真实事务依赖数据库ACID，而Mock若只做内存操作，可能掩盖死锁、幻读或预加载N+1问题。
- 事务内嵌套调用必须显式传递
*gorm.DB实例，不能复用全局db变量，否则Mock对象被绕过 -
Preload("Profile")需在Mock里手动构造关联字段，否则断言user.Profile.Namepanic - 测试事务失败场景时，Mock要模拟
tx.Rollback()后数据不写入——即所有变更仅作用于临时map副本
常见错误：
- 在测试中用
db.Unscoped().Delete()清库，但Mock没实现Unscoped方法，导致误判为“删除成功” - 对
Count(&total)返回固定值total=0，却忘了验证error == nil是否符合预期
用Testify+Ginkgo做断言比原生testing更稳
GORM返回的error类型常是<em>mysql.MySQLError</em>或sqlite3.Error，直接用if err != nil判断太粗粒度。需要验证具体错误码或消息。
- 用
testify/assert.ErrorContains(t, err, "Duplicate entry")捕获唯一键冲突 - 用
gomega.Expect(result.RowsAffected).To(Equal(int64(1)))确认更新影响行数 - 对软删除字段
DeletedAt，断言不能只看user.DeletedAt != nil，还要检查db.Unscoped().First()能否查到
别忽略零值陷阱：
-
user.CreatedAt.IsZero()在Mock里可能永远为true，应改为检查是否已赋值（如!user.CreatedAt.Before(time.Now().AddDate(0,0,-1))） -
json.RawMessage字段在Mock中若用nil初始化，序列化会panic，得用json.RawMessage([]byte("{}"))
GORM单元测试最难的从来不是“怎么写”，而是“怎么让Mock行为无限逼近真实DB的边界反馈”。比如MySQL的ON DUPLICATE KEY UPDATE在SQLite里没有对应语义，这时候Mock必须按目标数据库的行为建模，而不是按代码能不能跑通。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
