如何在Azure Blob Storage中删除特定文件名任意后缀的文件？

Azure Blob Storage没有直接支持通配符删除的API，但你可以通过服务端前缀过滤的方式精准获取目标文件，再逐个删除——这种方法不需要遍历整个37000个文件的文件夹，只会拉取和你指定的代理人ID匹配的少量文件，完全满足性能需求。

解决方案代码 #

下面是基于@azure/storage-blob SDK实现的批量删除函数，通过前缀过滤定位目标文件：

async function deleteBlobsByPrefix(account, accountKey, containerName, blobFolder, agentId) {
    try {
        const { BlobServiceClient, StorageSharedKeyCredential } = require("@azure/storage-blob");
        const sharedKeyCredential = new StorageSharedKeyCredential(account, accountKey);
        const blobServiceClient = new BlobServiceClient(
            `https://${account}.blob.core.windows.net`,
            sharedKeyCredential
        );

        const containerClient = blobServiceClient.getContainerClient(containerName);
        // 处理文件夹路径，确保前缀格式正确（去除首尾斜杠，避免路径错误）
        const cleanFolder = blobFolder.replace(/^\/|\/$/g, '');
        const prefix = cleanFolder ? `${cleanFolder}/${agentId}.` : `${agentId}.`;

        let deletedCount = 0;
        // 服务端过滤：只返回符合前缀的Blob，无需遍历全文件夹
        for await (const blob of containerClient.listBlobsByPrefix({ prefix })) {
            const blockBlobClient = containerClient.getBlockBlobClient(blob.name);
            const deleteResult = await blockBlobClient.deleteIfExists();
            if (deleteResult.succeeded) {
                deletedCount++;
            }
        }
        console.log(`已为代理人${agentId}删除${deletedCount}份旧保单文件`);
        return deletedCount > 0;
    } catch (e) {
        console.error('删除文件时出错：', e);
        return false;
    }
}

调用示例 #

删除代理人ID为目标值的所有旧保单文件：

let deleteResult = await deleteBlobsByPrefix(account, accountKey, "agents", "/eopolicies/", userData.agentid.toString());

关键说明 #

1. 服务端过滤的优势：listBlobsByPrefix是Azure Blob提供的服务端过滤接口，只会返回名称以指定前缀开头的Blob。对于你的场景，每个代理人最多只有几份旧文件，客户端只会拉取这几个文件，完全不会受到37000份总文件的影响，性能极高。
2. 路径处理：函数中自动去除了blobFolder首尾的斜杠，避免拼接出//eopolicies//2448.这类错误路径，确保能正确定位到目标文件。
3. 容错处理：使用deleteIfExists确保即使文件已被删除也不会抛出错误，同时统计实际删除的文件数量。

为什么通配符删除不可行？ #

Azure Blob的单个Blob删除接口（deleteIfExists）仅支持精确匹配Blob名称，不支持通配符（如2448.*），因此必须先定位到具体的Blob才能删除。但通过前缀过滤的方式已经是最接近"无需遍历"的最优方案。

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