如何Mock Azure Blob Storage的BlobClient.WithVersion(versionId)方法？

问题原因分析 #

1. 未Mock时的ArgumentNullException：你Mock的BlobClient实例未正确初始化内部Uri，WithVersion方法内部会调用BlobUriBuilder处理Uri，空Uri会触发参数空异常。
2. 直接Mock失败的NotSupportedException：BlobClient.WithVersion是非虚方法，Moq仅支持Mock虚方法、抽象方法或接口成员，因此无法直接对该方法设置Mock逻辑。

可行解决方案 #

方案一：使用BlobsModelFactory创建合法的BlobClient实例 #

通过BlobsModelFactory生成带有有效Uri的BlobClient，避免空Uri问题，同时可以正常调用WithVersion方法：

// 构造合法的Blob Uri
var blobUri = new Uri("https://dummyaccount.blob.core.windows.net/dummycontainer/dummyblob");
// 使用工厂创建BlobClient实例
var blobClient = BlobsModelFactory.BlobClient(blobUri);

// 此时调用WithVersion不会报错，可正常获取版本化客户端
var versionedClient = blobClient.WithVersion("target-version-id");

如果需要对版本化客户端的后续行为做Mock，可以基于这个实例再进行包装，或者直接用工厂生成符合测试需求的客户端。

方案二：依赖IBlobClient抽象接口（推荐） #

Azure.Storage.Blobs提供了IBlobClient抽象接口（位于Azure.Storage.Blobs.Abstractions命名空间），将代码依赖从具体的BlobClient类改为该接口，即可直接用Moq Mock所有方法：

using Azure.Storage.Blobs.Abstractions;

// Mock IBlobClient接口
var mockBlobClient = new Mock<IBlobClient>();

// 正常设置WithVersion的Mock逻辑
mockBlobClient.Setup(x => x.WithVersion(It.IsAny<string>()))
              .Returns(mockBlobClient.Object); // 可返回另一个Mock的IBlobClient实例以模拟不同行为

这种方式符合依赖倒置原则，也让测试更灵活。

方案三：封装自定义服务层 #

如果无法修改现有代码的依赖关系，可以封装一个自定义服务类，将BlobClient的操作包裹起来，再Mock这个服务类：

// 定义抽象服务接口
public interface IBlobVersionService
{
    BlobClient GetVersionedClient(string versionId);
    // 添加其他业务需要的Blob操作方法
}

// 实现服务类
public class BlobVersionService : IBlobVersionService
{
    private readonly BlobClient _baseClient;

    public BlobVersionService(BlobClient baseClient)
    {
        _baseClient = baseClient;
    }

    public BlobClient GetVersionedClient(string versionId)
    {
        return _baseClient.WithVersion(versionId);
    }
}

测试时只需MockIBlobVersionService，完全避开直接操作BlobClient的非虚方法。

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