C#使用Moq验证实例方法调用次级方法遇到报错该如何解决？

和你之前熟悉的Ruby生态下的动态Mock工具不同，Moq 是基于 .NET 自带的动态代理（Castle DynamicProxy）实现的测试工具，原生仅支持拦截、验证可被派生类重写的成员：包括标注virtual的实例方法、属性、事件，以及接口的所有公开成员。对于类中默认的非虚方法（隐式密封，不允许派生类重写），Moq 无法生成代理逻辑做拦截，这也是你遇到两类报错的核心原因。

已遇到的报错本质 #

• 第一个编译错误：Mock<T>本身是对被Mock对象的包装类，并不是T的真实实例，要获取被代理包装的对象必须访问.Object属性，直接在Mock<Subject>实例上调用业务方法自然找不到对应成员。
• 第二个运行时异常：你给Subject类中的MainMethod、KidMethod、AdultMethod都没有添加virtual修饰，Moq 无法重写这些成员做调用拦截，因此无法执行Setup或验证逻辑。

方案1：调整业务类结构适配Moq能力 #

如果可以修改原类的代码，最直接的方式是将需要被拦截的成员加上virtual修饰，让代理可以正常生成重写逻辑：

public class Subject
{
    private readonly int _age;

    public Subject(int age)
    {
        _age = age;
    }

    // 标注virtual 允许代理重写
    public virtual void MainMethod()
    {
        if(_age <= 13)
        {
            KidMethod();
        }
        else
        {
            AdultMethod();
        }
    }

    public virtual void KidMethod() {}
    public virtual void AdultMethod() {}
}

⚠️ 关键配置提醒：Moq 生成的代理类默认会替换所有虚方法的实现为空逻辑，如果需要保留原类的业务逻辑、仅验证内部子方法的调用关系，必须手动开启CallBase配置，让未手动指定Mock行为的方法自动调用基类的原始实现：

[Test]
public void MainMethod_ShouldCallKidMethod_IfAgeBelow13()
{
    // 传入构造参数12初始化Mock对象，开启CallBase保留原实现
    var subjectMock = new Mock<Subject>(12) {
        CallBase = true
    };
    
    // 调用真实业务逻辑
    subjectMock.Object.MainMethod();
    
    // 验证KidMethod被调用1次，AdultMethod未被调用
    subjectMock.Verify(s => s.KidMethod(), Times.Once);
    subjectMock.Verify(s => s.AdultMethod(), Times.Never);
}

方案2：拆分依赖面向接口Mock（推荐写法） #

从单元测试的设计原则出发，被测对象应该使用真实实例，只有其外部依赖才需要替换为Mock对象。你当前的代码逻辑中，Subject直接调用自身的方法，本质是内部逻辑耦合度太高，才需要靠Mock自身来验证调用关系。
更合理的可测试设计是将需要被验证的方法抽取为独立接口，通过依赖注入解耦：

1. 定义抽象接口：

   public interface IChildAdultAction
   {
       void KidMethod();
       void AdultMethod();
   }
   

2. 调整Subject类，将内部方法调用的依赖替换为接口实例：

   public class Subject
   {
       private readonly int _age;
       private readonly IChildAdultAction _action;
   
       public Subject(int age, IChildAdultAction action)
       {
           _age = age;
           _action = action;
       }
   
       // 该方法不需要加virtual，因为测试时会用真实实例运行
       public void MainMethod()
       {
           if(_age <= 13)
           {
               _action.KidMethod();
           }
           else
           {
               _action.AdultMethod();
           }
       }
   }
   

3. 测试时直接Mock接口对象，验证其方法调用即可——接口所有成员天生可被代理，完全适配Moq能力，且测试过程跑的是真实的Subject业务逻辑，不会受代理逻辑干扰：

   [Test]
   public void MainMethod_ShouldCallKidMethod_IfAgeBelow13()
   {
       // Mock外部依赖
       var actionMock = new Mock<IChildAdultAction>();
       // 构造真实的被测Subject实例，注入Mock依赖
       var subject = new Subject(12, actionMock.Object);
       
       // 执行被测逻辑
       subject.MainMethod();
       
       // 验证依赖方法的调用关系
       actionMock.Verify(a => a.KidMethod(), Times.Once);
       actionMock.Verify(a => a.AdultMethod(), Times.Never);
   }
   

能力边界说明 #

• 密封类、非虚实例方法、静态方法是Moq原生不支持的拦截场景，如果必须验证这类调用，需要引入支持IL运行时改写的第三方测试工具，但这类工具有额外的使用成本，不推荐替代正常的可测试代码设计。
• 单元测试中应避免对被测类本身做全量Mock，否则你实际测试的是Moq生成的代理逻辑，而不是你真实写的业务代码，会失去单元测试的意义。

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