go-zero 框架编写自动化单元测试的核心做法是利用 go test 结合 testify 库,通过 mock 外部依赖(如数据库、rpc)来隔离测试环境。具体操作是定义接口并创建 mock 实现,在测试用例中注入这些 mock 实例,最后使用断言验证业务逻辑的正确性。这样做可以确保测试快速、稳定且不依赖真实的基础设施。

如何为 Service 层编写基于 Mock 的单元测试
针对 Go-Zero 生成的 Service 代码,直接测试包含数据库或 RPC 调用的方法会导致测试不稳定。正确的做法是提取接口,使用 gomock 生成 Mock 对象,并在测试中替换真实的依赖项。

package service
import (
"context"
"testing"
"github.com/stretchr/testify/assert"
"github.com/zeromicro/go-zero/core/mr"
)
// 假设这是你的 service 结构体
type MyService struct {
UserModel UserModel
}
// 测试用例
testGetUser(t *testing.T) {
// 1. 创建 Mock 对象 (需提前用 mockgen 生成)
mockUserModel := NewMockUserModel(ctrl)
// 2. 设置期望行为
ctx := context.Background()
expectedUser := &models.User{Id: 1, Name: "Alice"}
mockUserModel.EXPECT().FindOne(ctx, int64(1)).Return(expectedUser, nil)
// 3. 实例化 Service 并注入 Mock
svc := &MyService{UserModel: mockUserModel}
// 4. 执行调用
user, err := svc.GetUser(ctx, 1)
// 5. 断言结果
assert.NoError(t, err)
assert.Equal(t, "Alice", user.Name)
}
上述代码展示了标准的测试流程:首先通过 NewMockUserModel 创建模拟对象,接着使用 EXPECT() 链式调用定义当调用 FindOne 时返回特定数据。随后将 Mock 注入到 MyService 中,调用业务方法后,使用 assert.NoError 和 assert.Equal 验证返回值是否符合预期。这种方法完全隔离了数据库连接,使得测试可以在任何环境中运行。
如何处理并发场景下的单元测试
Go-Zero 服务常涉及并发处理,例如使用 mr.Map 或 Goroutine 池。测试并发代码的关键在于控制调度顺序或使用同步原语确保所有协程完成后再进行断言。可以通过 sync.WaitGroup 等待所有任务结束,或者使用 t.Parallel() 并行运行独立的测试用例以提高效率。

sync.WaitGroup











