如何配置NSubstitute不调用内部虚方法及内部方法单元测试咨询

首先来解答你的两个核心疑问：

为什么x.Save()会调用真实实现？ #

这是因为你要拦截的Save()是internal方法，.NET默认限制了跨程序集访问internal成员，而你的测试项目大概率是独立于被测试项目的另一个程序集。即使你用Substitute.ForPartsOf<Email>()创建了部分模拟对象，NSubstitute的动态代理机制在处理internal虚拟方法时会受到访问权限的限制——它无法正确生成能拦截internal方法的代理，除非你显式开放访问权限。

另外，就算你让测试程序集能访问internal成员，ForPartsOf对internal方法的拦截支持也不如public方法稳定，这就是为什么改成public后测试正常的原因。

这种测试内部方法的方式是否正确？ #

不太推荐。单元测试的核心是测试类的公开行为（也就是Send()方法），而不是内部实现细节（Save()方法）。直接测试内部方法会让你的测试和实现细节绑定得太紧：如果后续你重构代码，把Save()的逻辑拆分或替换，即使Send()的行为完全正常，测试也可能失败，违背了单元测试“验证行为而非实现”的原则。

给你的几点建议 #

1. 优先测试公开API，避免直接测试内部方法 #

把测试焦点放在Send()方法上：验证调用Send()后，是否达到了预期的结果（比如邮件是否被标记为已发送，相关数据是否被正确持久化等），而不是去直接测试Save()。

2. 解决internal方法的拦截问题（如果必须模拟它） #

如果你只是需要在测试Send()时拦截Save()的调用，不想让它执行真实逻辑，可以这么做：

• 在被测试项目的AssemblyInfo.cs（或项目文件的<ItemGroup>里）添加两个InternalsVisibleTo属性：

  // 让测试程序集能访问internal成员
  [assembly: InternalsVisibleTo("YourTestProjectAssemblyName")]
  // 让NSubstitute的动态代理程序集能访问internal成员，否则拦截会失效
  [assembly: InternalsVisibleTo("DynamicProxyGenAssembly2")]
  

  这样NSubstitute就能正确拦截internal的虚拟方法了。

3. 优化代码设计，让测试更优雅 #

更好的方案是用依赖倒置原则，把Save()的逻辑抽象成独立的接口，比如：

public interface IEmailStorage
{
    Task<bool> SaveEmail();
}

public class Email
{
    private readonly IEmailStorage _storage;

    public Email(IEmailStorage storage)
    {
        _storage = storage;
    }

    public async Task<bool> Send()
    {
        // 发送逻辑
        await _storage.SaveEmail();
        return true;
    }
}

这样测试时，你不需要用ForPartsOf这种部分模拟，直接给Email注入一个模拟的IEmailStorage即可：

var mockStorage = Substitute.For<IEmailStorage>();
mockStorage.SaveEmail().Returns(true);

var email = new Email(mockStorage);
await email.Send();

// 验证SaveEmail是否被调用
await mockStorage.Received(1).SaveEmail();

这种方式不仅让测试更简单，还提升了代码的可扩展性和可维护性。

4. 退而求其次：把Save改成protected #

如果不想引入接口，也可以把Save()的访问修饰符改成protected virtual，这样你可以在测试项目中创建Email的子类，覆盖Save()方法，同样能避免调用真实逻辑：

public class TestableEmail : Email
{
    public bool SaveCalled { get; private set; }

    protected override async Task<bool> Save()
    {
        SaveCalled = true;
        return true;
    }
}

// 测试代码
var email = new TestableEmail();
await email.Send();
Assert.True(email.SaveCalled);

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