Go使用testify单测报BeginTxx非预期mock调用错误排查

你的测试代码存在3个直接导致BeginTxx mock不生效的问题：

• 核心问题：mock注册逻辑从未执行。你在测试用例结构体里定义了onSQLMock、onOtherFuncMock两个用来注册mock预期的回调字段，但在for循环遍历用例、新建usecase实例后，根本没有调用这两个回调，等于你写的BeginTxx返回配置从来没有绑定到实际运行测试的mock对象上，testify自然会报方法调用未预期的错误。
• mock注册绑错了实例。就算你调用了回调，当前回调里写的是sqlRepo.On(...)，但回调的入参是当前用例新建的sqlMock *mocks.SQLRepository，这里的sqlRepo是外部未初始化的游离变量，不是实际注入到usecase里的mock实例，注册逻辑完全不生效。
• 语法错误：第二个失败用例的Return参数缺失右括号，代码本身就无法正常编译：sqlRepo.On("BeginTxx").Return(tx, errors.New("Failed to begin tx") 末尾少了闭合的)。

1. 修正测试用例循环逻辑 #

遍历用例时，先新建当前用例专属的mock实例，执行对应回调注册mock预期，再把mock注入usecase，最后加上mock预期校验：

for _, testCase := range testCases {
    t.Run(testCase.name, func(t *testing.T) {
        // 每个用例新建独立mock，避免用例间污染
        sqlMock := new(mocks.SQLRepository)
        otherMock := new(mocks.OtherFuncMock)

        // 注册当前用例的mock逻辑
        if testCase.onSQLMock != nil {
            testCase.onSQLMock(sqlMock)
        }
        if testCase.onOtherFuncMock != nil {
            testCase.onOtherFuncMock(otherMock)
        }

        // 注入mock到待测试的usecase
        uc := &usecase{
            sqlRepo: sqlMock,
            otherFuncMock: otherMock,
        }

        actualErrx := uc.Calculate(context.Background(), testCase.id)

        // 校验所有注册的mock方法都按预期被调用
        sqlMock.AssertExpectations(t)
        otherMock.AssertExpectations(t)

        if testCase.wantError {
            require.EqualError(t, actualErrx, testCase.expectedError)
            return
        }
        require.NoError(t, actualErrx)
    })
}

2. 修正测试用例里的mock注册逻辑 #

把回调里错误的sqlRepo.On改成传入的sqlMock.On，同时补全缺失的语法括号：

{
    name: "Successfully Calculated",
    onSQLMock: func(sqlMock *mocks.SQLRepository) {
        var tx *sqlx.Tx
        sqlMock.On("BeginTxx").Return(tx, nil)
    },
    onOtherFuncMock: func(otherFuncMock *mocks.OtherFuncMock) {
        // 其他方法的mock逻辑
    },
    wantError: false,
},{
    name: "Failed to calculate",
    onSQLMock: func(sqlMock *mocks.SQLRepository) {
        var tx *sqlx.Tx
        // 补全右括号，使用传入的sqlMock实例注册
        sqlMock.On("BeginTxx").Return(tx, errors.New("Failed to begin tx"))
    },
    onOtherFuncMock: func(otherFuncMock *mocks.OtherFuncMock) {
        // 其他方法的mock逻辑
    },
    wantError: true,
    expectedError: "Failed to begin tx",
},

• 表驱动测试不要复用全局mock实例，每个用例单独新建mock，避免不同用例的预期配置互相干扰。
• 每个用例执行末尾必须调用AssertExpectations，校验所有注册的mock方法都被正确调用，避免漏测调用逻辑、参数不匹配等问题。
• 注册mock时必须使用当前用例传入的mock实例，不要引用外部同名的游离变量。

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