Azure Function调试触发异常及读取Blob压缩文件夹问题求助

一、让Azure Function重复触发BlobTrigger用于调试 #

• 重新上传目标文件/压缩包：BlobTrigger默认仅在blob新增或修改时触发，直接重新上传相同文件（或修改文件名后上传），会触发新的执行。
• 修改Blob元数据：在Azure存储账户中找到目标blob，编辑其元数据（比如添加一个自定义键值对）并保存，触发器会识别为变更并触发。
• 本地调试重置触发器状态：如果用Azurite本地存储，删除存储中的azure-webjobs-hosts容器（该容器存储触发器的执行记录），重启Function后重新上传文件即可重复触发。

二、读取压缩文件夹（ZIP文件）内容的正确方式 #

问题分析 #

你的代码直接将所有触发的blob流当作ZIP文件处理，会导致非ZIP文件报错；同时Blob存储中没有“压缩文件夹”的概念，只有ZIP格式的文件blob，需确保触发器匹配到ZIP文件，再进行解析。

修正后的代码示例 #

[FunctionName("FileFunction")]
public async Task Run([BlobTrigger("ContainerName/{folder}/{name}", Connection = "AzureJobsStorage")] Stream stream, string folder, string name, IDictionary<string, string> metadata)
{
    Log.Information("'{name}' was uploaded to folder '{folder}'.", name, folder);

    // 仅处理ZIP格式文件
    if (name.EndsWith(".zip", StringComparison.OrdinalIgnoreCase))
    {
        try
        {
            // 重置流位置（避免流已被读取导致ZipArchive报错）
            stream.Position = 0;
            using (ZipArchive archive = new ZipArchive(stream, ZipArchiveMode.Read))
            {
                foreach (ZipArchiveEntry entry in archive.Entries)
                {
                    // 跳过空目录项
                    if (string.IsNullOrEmpty(entry.Name)) continue;
                    Log.Information("ZIP内文件：{FullName}", entry.FullName);
                    // 如需读取文件内容，可使用entry.Open()获取流
                    // using (var entryStream = entry.Open())
                    // {
                    //     // 处理文件内容
                    // }
                }
            }
        }
        catch (InvalidDataException ex)
        {
            Log.Error("文件不是有效的ZIP格式：{Name}", name, ex);
        }
    }
    else
    {
        // 处理普通文件逻辑
        Log.Information("处理普通文件：{Name}", name);
    }
}

关键注意点 #

• 匹配ZIP文件：通过文件名后缀.zip过滤目标文件，避免非ZIP流导致的异常。
• 重置流位置：Blob流可能被触发器提前读取过，需重置Position = 0后再创建ZipArchive。
• 跳过空目录：ZIP中的空目录项entry.Name为空，需跳过避免无效处理。

三、断点无法命中的排查 #

• 确认本地调试时，Function已正确连接到存储账户（检查local.settings.json中的AzureJobsStorage配置）。
• 确保断点设置在Run方法的第一行，且调试器已附加到Function进程。
• 检查日志中的“获取主机锁租约”说明Function主机已启动，需确保触发条件满足（如上传新的blob）。

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