C# Mock框架验证方法调用次数（手把手教你用Moq验证方法被调用了几次）

什么是Mock框架？

Mock框架（如Moq、NSubstitute等）允许我们在不依赖真实实现的情况下，创建接口或类的“假”实例。这些假实例可以预设行为（例如返回特定值），也可以记录方法是否被调用、调用了多少次等。

为什么需要验证方法调用次数？

在某些业务逻辑中，方法调用的频率至关重要。例如：

• 缓存失效后应重新加载数据（只调用一次）
• 失败后自动重试机制（应调用3次）
• 避免重复发送邮件（不能超过1次）

这时，我们就需要在单元测试中验证方法调用次数，确保代码行为符合预期。

准备工作：安装Moq

首先，在你的测试项目中通过NuGet安装Moq：

dotnet add package Moq

实战：使用Moq验证方法调用次数

假设我们有一个 IEmailService 接口和一个 NotificationManager 类：

public interface IEmailService{    void SendEmail(string to, string subject, string body);}public class NotificationManager{    private readonly IEmailService _emailService;    public NotificationManager(IEmailService emailService)    {        _emailService = emailService;    }    public void NotifyUser(string email)    {        _emailService.SendEmail(email, "Welcome", "Hello new user!");    }}

现在，我们要写一个单元测试，验证当调用 NotifyUser 时，SendEmail 方法**恰好被调用一次**。

编写测试代码

using Moq;using Xunit;public class NotificationManagerTests{    [Fact]    public void NotifyUser_ShouldCallSendEmail_Once()    {        // Arrange        var mockEmailService = new Mock<IEmailService>();        var notificationManager = new NotificationManager(mockEmailService.Object);        // Act        notificationManager.NotifyUser("test@example.com");        // Assert        mockEmailService.Verify(            x => x.SendEmail("test@example.com", "Welcome", "Hello new user!"),            Times.Once()        );    }}

关键点在于 Verify 方法配合 Times.Once()。Moq提供了多种调用次数验证方式：

• Times.Once()：恰好调用1次
• Times.Never()：从未调用
• Times.AtLeastOnce()：至少调用1次
• Times.Exactly(n)：恰好调用n次
• Times.AtMost(n)：最多调用n次

高级技巧：忽略参数验证调用次数

有时我们只关心方法是否被调用，而不关心具体参数。这时可以使用 It.IsAny<T>()：

mockEmailService.Verify(    x => x.SendEmail(It.IsAny<string>(), It.IsAny<string>(), It.IsAny<string>()),    Times.Once());

总结

通过本教程，你已经掌握了在C#中使用Mock框架（特别是Moq）来验证方法调用次数的核心技能。这不仅能提升你的单元测试Mock能力，还能让你写出更可靠、更健壮的代码。

记住，良好的单元测试不仅要验证返回值，还要验证行为——而方法调用次数正是行为验证的关键一环。希望这篇Moq使用教程对你有所帮助！

小贴士：多练习不同场景下的调用验证，比如重试逻辑、事件触发等，你会越来越熟练！