如何用Moq模拟抽象类中带泛型返回值的受保护方法？

问题重现 #

你需要测试UserRepository的GetUserById方法，该方法调用了基类AbstractRepository<T>中定义的受保护虚拟方法GetById。尝试用Moq拦截该受保护方法时，实际的基类方法总是被执行，两种尝试的方案均未生效。

相关代码如下：

抽象类 #

public abstract class AbstractRepository<T> where T : class
{
    protected virtual async Task<T> GetById(int id)
    {
        // 原始实现
    }
}

实现类 #

public class UserRepository : AbstractRepository<User>
{
    public Task<User> GetUserById(int id)
    {
        return base.GetById(id);
    }
}

测试代码（初始版本） #

[Theory]
public async Task GetUserById_UserExists_ReturnsUser(User user)
{
    Mock<UserRepository> mockRealSut = new(MockBehavior.Strict, new object[] {})
    {
        CallBase = true
    };

    // 尝试的Mock Setup未生效
    User result = await mockRealSut.Object.GetUserById(1);
}

问题原因分析 #

1. 方案1的问题：语法本身无错误，但MockBehavior.Strict与CallBase=true的组合可能干扰了Moq的拦截逻辑，导致未正确触发Mock的返回值。
2. 方案2的问题：接口方法的public访问修饰符与基类方法的protected不匹配，Moq无法将接口方法与受保护的基类方法关联，因此无法拦截调用。

正确解决方案 #

调整Moq的配置和Setup方式，确保精准匹配受保护方法的签名，同时避免行为模式冲突：

修正后的测试代码 #

[Theory]
public async Task GetUserById_UserExists_ReturnsUser(User user)
{
    // 改用默认的Loose模式，避免Strict模式带来的不必要限制
    var mockRepo = new Mock<UserRepository>
    {
        CallBase = true
    };

    // 正确Setup受保护的GetById方法，明确指定返回值类型和参数匹配规则
    mockRepo.Protected()
        .Setup<Task<User>>("GetById", ItExpr.IsAny<int>())
        .ReturnsAsync(user);

    // Act
    User result = await mockRepo.Object.GetUserById(1);

    // Assert
    Assert.Equal(user, result);
}

关键说明 #

• 移除MockBehavior.Strict：Strict模式要求所有被调用的方法必须提前Setup，虽然CallBase=true可以规避，但会增加测试复杂度，Loose模式更适合当前场景。
• 精准匹配方法签名：Setup<Task<User>>("GetById", ItExpr.IsAny<int>())明确指定了返回值类型和参数，确保Moq能正确识别并拦截基类的GetById调用。
• 保留CallBase=true：确保UserRepository中未被Mock的方法（如GetUserById）会调用实际实现，而被Setup的受保护方法则使用Mock的返回值。

额外优化建议 #

如果后续需要频繁模拟这类泛型仓储的受保护方法，可以封装扩展方法简化Setup：

public static class MoqProtectedExtensions
{
    public static IReturnsResult<TMock> SetupGetById<TMock, TEntity>(this ProtectedMock<TMock> mock, TEntity entity)
        where TMock : AbstractRepository<TEntity>
        where TEntity : class
    {
        return mock.Setup<Task<TEntity>>("GetById", ItExpr.IsAny<int>())
                   .ReturnsAsync(entity);
    }
}

使用时只需一行代码：

mockRepo.Protected().SetupGetById(user);

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