如何在Azure Blob存储中按ImageId前缀获取Blob并忽略虚拟文件夹？

问题背景 #

你的Azure Blob容器images中，Blob采用{imageSize}/{imageId}-{imageName}.extension的命名结构，例如：

• s/2456-earth.png
• m/2456-earth.png

你希望通过imageId（如2456）获取所有对应尺寸的Blob，但直接使用prefix: "2456"无法匹配到任何Blob——因为Azure Blob的prefix参数仅匹配Blob名称起始部分，而你的Blob名称均以尺寸前缀开头。

当前你采用循环遍历所有尺寸前缀的方案，但需要发起多次请求，性能和代码简洁性都不理想。

解决方案 #

方案1：使用Blob索引标签（推荐，性能最优） #

如果可以修改Blob的上传逻辑，给每个Blob添加imageId索引标签，之后就能通过标签直接过滤所有匹配的Blob，仅需一次请求。

上传时添加标签

上传Blob时，为其设置imageId标签（以s/2456-earth.png为例）：

var blobClient = containerClient.GetBlobClient("s/2456-earth.png");
await blobClient.UploadAsync(fileStream, new BlobUploadOptions
{
    Tags = new Dictionary<string, string> { { "imageId", "2456" } }
});

查询时按标签过滤

通过BlobIndexMatch指定标签条件，一次性获取所有匹配imageId=2456的Blob：

var indexMatch = new BlobIndexMatch("imageId", "2456");
var blobs = containerClient.GetBlobsAsync(
    BlobTraits.None, 
    BlobStates.None, 
    conditions: new BlobRequestConditions { BlobIndexMatch = indexMatch }
);

await foreach (var blob in blobs)
{
    // 处理匹配到的Blob
    Console.WriteLine(blob.Name);
}

方案2：并行请求优化原有循环 #

如果无法修改上传流程，可将原有循环改为并行异步请求，减少总耗时，同时简化代码结构：

var sizes = new List<string> { "xs", "s", "m", "l", "xl" };

// 并行发起所有请求
var blobTasks = sizes.Select(size => 
    containerClient.GetBlobsAsync(BlobTraits.None, BlobStates.None, prefix: $"{size}/2456").ToListAsync()
);

// 等待所有请求完成并合并结果
var allMatchingBlobs = (await Task.WhenAll(blobTasks)).SelectMany(blobs => blobs);

foreach (var blob in allMatchingBlobs)
{
    // 处理Blob
    Console.WriteLine(blob.Name);
}

关键说明 #

• Azure Blob的prefix匹配规则是从Blob名称的第一个字符开始匹配，因此直接用imageId作为前缀无法命中任何Blob（因为Blob名称起始是尺寸字符串）。
• 方案1的Blob索引标签是Azure提供的原生元数据过滤能力，查询效率远高于客户端过滤或多请求循环，是长期最优解。

内容的提问来源于stack exchange，提问作者Q.Aimad