Go测试中gomock.InOrder与子测试执行顺序异常求助

问题根源 #

你遇到的核心问题有两个：

1. Go Map遍历的无序性：Go语言中map的遍历顺序是随机的（每次运行可能不同），用map存储测试用例时，子测试的执行顺序无法保证和你定义的test1/test2/test3顺序一致。
2. Gomock InOrder的严格顺序约束：你通过gomock.InOrder()设置了Get("1")→Get("2")→Get("3")的严格调用顺序期望，但子测试实际执行顺序随机，导致第一个执行的子测试调用的Get参数不符合InOrder的第一个期望，触发错误。

首次运行正常只是巧合（刚好map遍历顺序和期望顺序一致），调试时顺序固定、go clean -cache偶尔有效也都是随机因素导致的，本质和缓存无关。

解决方案 #

方案1：改用切片固定测试用例顺序 #

把测试用例从map改成切片（切片是有序结构），确保子测试执行顺序和Gomock期望的顺序完全一致：

service := NewService()

// 定义测试用例结构体
type testCase struct {
    name     string
    param1   string
    param2   string
    // 其他参数
    expected bool
}

// 用切片存储，固定顺序
tests := []testCase{
    {"test1", "1", "...", true},
    {"test2", "2", "...", false},
    {"test3", "3", "...", true},
}

// 按切片顺序设置InOrder期望
gomock.InOrder(
    storer.EXPECT().Get("1").Return(...),
    storer.EXPECT().Get("2").Return(...),
    storer.EXPECT().Get("3").Return(...),
)

// 遍历切片执行子测试
for _, test := range tests {
    t.Run(test.name, func(t *testing.T) {
        res := service.FUNCTION_TO_TEST(test.param1, test.param2, ...)
        assert.Equal(t, test.expected, res)
    })
}

方案2：子测试独立设置Mock期望（推荐） #

单元测试的核心原则是测试用例隔离，共享同一个Mock实例会导致测试用例之间互相影响。正确的做法是在每个子测试内部创建独立的Mock控制器和期望：

// 不要在全局创建Mock或设置期望
for name, test := range tests {
    t.Run(name, func(t *testing.T) {
        // 每个子测试创建独立的Mock控制器
        ctrl := gomock.NewController(t)
        defer ctrl.Finish() // 自动校验Mock期望

        // 创建Mock实例
        storer := mocks.NewMockStorer(ctrl)
        // 只设置当前测试用例需要的期望，无需关心顺序
        storer.EXPECT().Get(test.param1).Return(...)

        // 注入Mock到被测服务
        service := NewService(storer)
        res := service.FUNCTION_TO_TEST(test.param1, test.param2, ...)
        assert.Equal(t, test.expected, res)
    })
}

这种方式下，每个子测试的Mock都是独立的，完全不受其他测试用例执行顺序的影响，也符合单元测试的最佳实践。

内容的提问来源于stack exchange，提问作者KronwarsCZ