如何使用C#下载Blob容器按年/月/日/时层级存储的当前小时所有Blob文件

现有写法的性能问题 #

• 你当前通过GetBlobs()全量拉取容器所有Blob元数据再本地过滤的写法存在明确的性能隐患：如果容器中存储了大量历史日志文件，每次调用都会拉取所有Blob的元数据返回客户端，不仅会占用大量带宽、增加API请求耗时，还会浪费Azure存储的API请求配额，文件量越大性能衰减越明显。
• 额外逻辑漏洞：如果存在补传历史时段日志的场景，Blob的最后修改时间和路径标识的时段不一致，会导致过滤结果错误，出现漏下载或多下载的问题。

直接定位小时文件夹的实现方法 #

Azure Blob存储本身支持服务端前缀匹配，你可以直接构造对应小时的路径前缀作为查询参数，服务端只会返回该路径下的所有Blob，无需客户端二次过滤，性能提升非常明显。
实现步骤如下：

1. 按照你的路径规则（年/月/日/时）构造当前UTC时间的前缀字符串，注意月、日、时都要补零到2位
2. 调用GetBlobsAsync方法时传入前缀参数，直接获取目标小时文件夹下的所有Blob
3. 批量下载即可

示例代码 #

var blobServiceClient = new BlobServiceClient("conn-str");
BlobContainerClient containerClient = blobServiceClient.GetBlobContainerClient("log-test");

// 构造当前UTC时间的前缀，D2表示补零到2位，适配目录命名规则
var nowUtc = DateTime.UtcNow;
string prefix = $"{nowUtc.Year}/{nowUtc.Month:D2}/{nowUtc.Day:D2}/{nowUtc.Hour:D2}/";

// 服务端直接过滤前缀，只返回目标小时文件夹下的Blob
await foreach (var blobItem in containerClient.GetBlobsAsync(prefix: prefix))
{
    BlobClient blobClient = containerClient.GetBlobClient(blobItem.Name);
    // 替换路径分隔符后保存到本地
    string localPath = $"C:\\Temp\\{blobItem.Name.Replace('/', '-')}";
    await blobClient.DownloadToAsync(localPath);
}

该方案的优势 #

• 所有过滤逻辑在Azure存储服务端执行，返回的数据量仅为目标时段的Blob元数据，请求耗时、带宽占用、内存占用都大幅降低
• 完全匹配你的目录结构规则，不受Blob最后修改时间影响，逻辑准确性更高
• 异步枚举的实现方式更适合后台长时间运行的任务，避免同步阻塞

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