使用mock数据库可解决Go测试中依赖外部环境、速度慢等问题。1. sqlmock库可模拟SQL查询、参数匹配等，适用于基于database/sql的驱动；2. testify/mock结合接口抽象实现灵活mock，适合依赖注入场景；3. SQLite内存模式或Testcontainers提供接近真实的行为，无需mock SQL；4. GORM可通过sqlmock实例进行测试，但需处理额外元查询。根据项目结构选择合适方案可提升测试效率与可靠性。
在Go语言开发中，数据库测试常面临依赖外部环境、运行速度慢、数据状态难控制等问题。使用mock数据库能有效解决这些问题，提升单元测试的稳定性与执行效率。以下是几种常见的Golang mock数据库测试方法汇总，帮助你在不同场景下选择合适方案。
1. 使用 sqlmock 模拟 database/sql 操作
sqlmock 是最流行的用于 mock *sql.DB 的库，适用于基于 database/sql 接口的任何数据库驱动（如 MySQL、PostgreSQL）。
特点： 可以 mock SQL 查询、参数匹配、事务行为、错误返回等。
安装：
立即学习“go语言免费学习笔记（深入）”；
go get github.com/DATA-DOG/go-sqlmock
示例代码：
func TestUserRepository_GetByID(t *testing.T) {
db, mock, err := sqlmock.New()
if err != nil {
t.Fatalf("failed to open mock sql: %v", err)
}
defer db.Close()
rows := sqlmock.NewRows([]string{"id", "name"}).
AddRow(1, "Alice")
mock.ExpectQuery("^SELECT \\* FROM users WHERE id = \\?$").
WithArgs(1).
WillReturnRows(rows)
repo := &UserRepository{DB: db}
user, err := repo.GetByID(1)
if err != nil {
t.Errorf("unexpected error: %v", err)
}
if user.Name != "Alice" {
t.Errorf("expected name Alice, got %s", user.Name)
}
if err := mock.ExpectationsWereMet(); err != nil {
t.Errorf("unmet expectations: %v", err)
}}
注意调用 mock.ExpectationsWereMet() 验证所有预期操作是否被执行。
2. 使用 testify/mock 手动 mock 接口
如果你的代码已经将数据库操作抽象成接口，可以结合 testify/mock 实现更灵活的 mock。
定义接口：
type UserStorage interface {
GetByID(id int) (*User, error)
Create(user *User) error
}创建 mock 实现：
type MockUserStorage struct {
mock.Mock
}
func (m MockUserStorage) GetByID(id int) (User, error) {
args := m.Called(id)
return args.Get(0).(*User), args.Error(1)
}
测试中使用：
func TestUserService_GetProfile(t *testing.T) {
mockStorage := new(MockUserStorage)
service := &UserService{Storage: mockStorage}
expected := &User{ID: 1, Name: "Bob"}
mockStorage.On("GetByID", 1).Return(expected, nil)
result, err := service.GetProfile(1)
assert.NoError(t, err)
assert.Equal(t, "Bob", result.Name)
mockStorage.AssertExpectations(t)}
这种方式解耦更强，适合领域驱动设计或依赖注入场景。
3. 使用内存数据库替代真实数据库
某些情况下，使用真正的数据库但切换为内存模式更简单，比如 SQLite in-memory 或 Testcontainers 启动临时实例。
SQLite 内存模式示例：
db, err := gorm.Open(sqlite.Open(":memory:"), &gorm.Config{})
if err != nil {
t.Fatal("failed to init in-memory SQLite")
}建表并插入测试数据，执行业务逻辑后验证结果。优点是无需 mock SQL，行为接近真实；缺点是仍涉及数据库语法差异。
4. 结合 GORM 使用 sqlmock
GORM 底层使用 *sql.DB，因此可以直接传入 sqlmock 的 DB 实例。
db, mock, err := sqlmock.New()
if err != nil {
t.Fatal(err)
}
gormDB, err := gorm.Open(mysql.New(mysql.Config{
Conn: db,
}), &gorm.Config{})
// 然后像平时一样使用 gormDB 进行查询
repo := &UserRepo{DB: gormDB}
...
注意：GORM 会自动添加一些元信息查询（如表结构），可能需要额外 expect 这些语句，或使用 mock.MatchExpectationsInOrder(false) 放宽顺序限制。
基本上就这些主流做法。根据项目结构选择：若直接操作SQL，优先用 sqlmock；若已抽象接口，可用 testify/mock；追求真实行为可选内存数据库。合理使用能大幅提升测试效率和可靠性。
