针对Commerce Tools .NET/C# API的单元测试框架推荐及Mock问题咨询

推荐的单元测试Mock框架 #

• Moq：.NET生态中最主流的Mock框架，文档完善、社区支持充足，只要处理好第三方类的可Mock性问题就能正常使用。
• NSubstitute：语法简洁直观，对新手友好，无需显式配置虚方法即可Mock可继承类。
• FakeItEasy：采用自然语言风格的API，配置Mock行为的代码可读性高。

解决Moq无法重写对象的问题 #

你遇到的无法重写对象问题，大概率是因为Commerce Tools .NET API中的目标类是密封类（sealed），或者类中的方法未标记为虚方法（virtual）——Moq默认只能Mock接口、非密封类的虚方法/抽象方法。核心解决思路如下：

1. 适配器模式封装第三方API
   这是最通用的解决方案，通过自定义接口和适配器类，将Commerce Tools的原生API包装起来，后续测试时只需Mock自定义接口即可：

// 自定义业务接口
public interface ICommerceToolsProductService
{
    Task<Product> GetProductByIdAsync(string productId, CancellationToken cancellationToken = default);
}

// 适配器实现，对接Commerce Tools原生服务
public class CommerceToolsProductServiceAdapter : ICommerceToolsProductService
{
    private readonly ProductService _nativeProductService;

    public CommerceToolsProductServiceAdapter(ProductService nativeProductService)
    {
        _nativeProductService = nativeProductService;
    }

    public async Task<Product> GetProductByIdAsync(string productId, CancellationToken cancellationToken = default)
    {
        var response = await _nativeProductService.GetByIdAsync(productId, new ApiRequestParameters(), cancellationToken);
        return response.Resource;
    }
}

测试时Mock自定义接口的示例：

var mockProductService = new Mock<ICommerceToolsProductService>();
mockProductService.Setup(s => s.GetProductByIdAsync("prod-123", It.IsAny<CancellationToken>()))
                  .ReturnsAsync(new Product { Id = "prod-123" });

2. 针对非密封类的虚方法Mock
   如果目标类是非密封的，且方法标记为virtual，直接在Moq中设置该方法的Mock行为即可，无需额外封装。

其他框架的使用示例 #

• NSubstitute示例：

var substituteProductService = Substitute.For<ICommerceToolsProductService>();
substituteProductService.GetProductByIdAsync("prod-123", Arg.Any<CancellationToken>())
                       .Returns(Task.FromResult(new Product { Id = "prod-123" }));

• FakeItEasy示例：

var fakeProductService = A.Fake<ICommerceToolsProductService>();
A.CallTo(() => fakeProductService.GetProductByIdAsync("prod-123", A<CancellationToken>.Ignored))
 .Returns(Task.FromResult(new Product { Id = "prod-123" }));

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