Moq使用It.IsSubtype匹配带IFoo约束泛型方法时报无隐式引用转换错误

错误原因说明 #

1. 编译错误的核心是It.IsSubtype<IFoo>是Moq的参数匹配器，仅可用于匹配方法的入参值，不能作为泛型参数的类型定义嵌套在Action<>的泛型声明中，属于Moq匹配器的用法错误。
2. 运行时空引用异常的触发原因是初始Setup仅匹配Action<IFoo>类型的入参，而Action<T>是逆变泛型，Action<Foo>和Action<IFoo>属于不同类型，Moq未命中配置的Setup，默认返回null导致后续调用报错。

正确解决方案 #

方案1：使用It.IsAnyType通配符（推荐，Moq 4.13及以上版本支持）

Moq 4.13版本开始提供的It.IsAnyType可以自动匹配符合泛型约束的所有类型，直接按如下方式配置，即可兼容所有实现IFoo的子类对应的Action<T>入参：

mock.Setup(e => e.DoSomething<It.IsAnyType>(It.IsAny<Action<It.IsAnyType>>()))
    .Returns(Mock.Of<IDisposable>());

因为DoSomething方法本身已经声明了where T : IFoo的类型约束，Moq会自动遵守该约束，不会匹配不符合条件的T类型，无需额外加过滤规则。

方案2：低版本Moq适配方案

如果使用的Moq版本低于4.13无法使用It.IsAnyType，可以选择两种适配方式：

• 方式一：针对所有用到的IFoo实现类单独配置Setup，适合用到的子类数量较少的场景：

// 匹配Foo子类的调用
mock.Setup(e => e.DoSomething(It.IsAny<Action<Foo>>()))
    .Returns(Mock.Of<IDisposable>());
// 有其他IFoo实现类时依次添加对应Setup即可

• 方式二：基于反射配置开放泛型方法的匹配规则，适合子类较多的场景：

// 获取DoSomething开放泛型方法的元数据
var doSomethingMethod = typeof(IMyClass).GetMethod(nameof(IMyClass.DoSomething));
mock.Setup(m => doSomethingMethod.Invoke(m, new object[] { It.IsAny<Delegate>() }))
    .Returns(Mock.Of<IDisposable>());

内容的提问来源于stack exchange，提问作者Red Riding Hood