Azure Functions独立进程（.NET8）BlobTrigger无法触发求助

问题 #

运行在.NET8独立进程环境下的BlobTrigger类型Azure Function，向存储账户上传文件时无法触发，需排查原因。

相关代码与配置 #

函数代码 #

[Function(nameof(ProcessData))]
[StorageAccount("StorageAccountConnectionString")]
public async Task Run([BlobTrigger("%MyDirectory%/{filename}")] 
    Stream jsonBlob, string filename)
{
    logger.LogInformation($"Triggered for file {filename}");
}

local.settings.json配置 #

{
  "IsEncrypted": false,
  "Values": {
    "StorageAccountConnectionString": "DefaultEndpointsProtocol=https;AccountName=*****",
    "MyDirectory": "container/folder1"
  }
}

依赖库配置 #

<TargetFramework>net8.0</TargetFramework>
<AzureFunctionsVersion>v4</AzureFunctionsVersion>
<OutputType>Exe</OutputType>
...
<PackageReference Include="Microsoft.Azure.Functions.Extensions" Version="1.1.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Storage" Version="6.2.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.20.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.16.2" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Timer" Version="4.3.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http" Version="3.1.0" />

排查步骤 #

• 补全存储连接字符串：当前StorageAccountConnectionString缺少AccountKey或SAS Token等认证信息，完整格式应为DefaultEndpointsProtocol=https;AccountName=xxx;AccountKey=xxx;EndpointSuffix=core.windows.net，无认证信息会导致函数无法访问存储账户，触发器失效。
• 确认文件上传路径：检查上传的文件是否确实放在container/folder1路径下，容器名和子文件夹名称需完全匹配，文件需直接处于folder1目录中，不能在更深层级的子文件夹内。
• 核对依赖包兼容性：当前依赖版本组合（Worker 1.20.0 + Storage Extensions 6.2.0）属于兼容范围，但可尝试更新所有Worker相关包到最新稳定版，排除版本冲突问题。
• 检查本地调试环境：如果是本地调试，使用Azurite模拟器时需将连接字符串改为UseDevelopmentStorage=true；若直接连接生产存储，要确保本地机器能访问该存储账户，且存储账户防火墙规则未限制本地IP。
• 查看函数启动日志：启动函数后观察控制台输出，确认是否存在连接失败、容器不存在、权限不足等报错信息，此类日志可直接定位问题根源。
• 验证触发器路径解析：启动日志中会显示BlobTrigger实际监听的路径，核对是否与container/folder1一致，确认配置中的%MyDirectory%是否正确解析。

内容的提问来源于stack exchange，提问作者O'Neil Tomlinson