使用C#从Azure Storage Blob获取匹配元数据的Blob无结果，代码排查

云上老周

2026-6-16

Azure Blob存储元数据过滤无结果的问题修复

你的代码存在两个核心问题，导致无法匹配到目标Blob：

1. 未递归遍历子文件夹

ListBlobs("ParentFolder")默认仅返回ParentFolder目录下的直接子项，不会深入到Subfolder1/2/3这类子目录中查找Blob。必须启用扁平列表模式才能递归获取所有子目录下的Blob。

2. 未主动加载Blob元数据

通过ListBlobs获取的CloudBlockBlob对象默认不会自动拉取元数据和完整属性，此时r.Metadata是空集合，自然无法匹配到Account=Test1的条件。需要手动调用FetchAttributes()方法加载元数据。

修复后的代码

private IOrderedEnumerable<CloudBlockBlob> GetListOfBlobs(string blobConnString)
{
    var cloudStorageAccount = CloudStorageAccount.Parse(blobConnString);
    var cloudBlobClient = cloudStorageAccount.CreateCloudBlobClient();

    var blobContainer = cloudBlobClient.GetContainerReference("ContainerName");
    // 启用扁平列表模式，递归获取所有子目录下的Blob
    var blobList = blobContainer.ListBlobs("ParentFolder", useFlatBlobListing: true);

    var matchBlobs = blobList.OfType<CloudBlockBlob>()
                             .Select(blob => 
                             {
                                 // 主动加载元数据和属性
                                 blob.FetchAttributes();
                                 return blob;
                             })
                             .Where(r => r.Metadata.Any(kv => kv.Key == "Account" && kv.Value == "Test1"))
                             .OrderBy(d => d.Properties.Created);

    return matchBlobs;
}