Moq使用ReturnsAsync设置mock方法返回值与预期不符问题排查

问题原因 #

你的核心问题是Moq配置的方法签名和实际调用/接口定义的方法签名不匹配，导致Moq没有命中你设置的返回规则，直接返回了布尔值的默认值false。

对照你的代码可以明确看到笔误：

• 你定义的IUserOption接口里的方法名为Value
• 但你在Mock配置和实际调用时，用的方法名都是GetValue

方法名不匹配的情况下，Moq无法识别你要配置的目标方法，自然不会返回你设置的true值。

修复方案 #

你只需要统一方法名即可，有两种修改方式：

方式1：修改Mock配置和调用的方法名，和接口定义保持一致 #

修改FakeUserOption的配置逻辑：

class FakeUserOption
{
    public static TUserOption Get<TUserOption, TReturn>(string key, TReturn value) where TUserOption : class,  IUserOption
    {
        var mock = new Mock<TUserOption>();
        // 将方法名从 GetValue 改为和接口一致的 Value
        mock.Setup(x => x.Value(It.IsAny<Guid>())).ReturnsAsync(value);
        return mock.Object;
    }
}

同时修改调用代码：

var fakeOption = FakeUserOption.Get<IExampleUserOption, bool>("someKey", true);
// 调用方法名改为 Value
var result = fakeOption.Value(new Guid()).Result;

方式2：修改接口定义的方法名，和现有配置/调用逻辑保持一致 #

如果你的业务逻辑中确实需要方法名为GetValue，直接修改IUserOption的方法定义即可：

interface IUserOption 
{
    // 方法名从 Value 改为 GetValue
    Task<object> GetValue(Guid userId);
}

其他注意点 #

如果GetValue是你为IUserOption定义的扩展方法，那么Moq无法直接Mock扩展方法（扩展方法本质是静态方法，不属于接口本身），这种情况你只需要Mock扩展方法内部调用的IUserOption原生方法即可。

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