本地调试Azure Blob触发函数：InputStream正常BlobClient无响应

可能原因 #

• 版本兼容性冲突：本地Azure Functions Runtime与Azure.Storage.Blobs NuGet包版本不匹配，导致BlobClient绑定在Azurite模拟环境下出现底层资源阻塞。云端环境的Runtime与SDK版本是对齐的，因此能正常运行。
• 异步操作阻塞：如果函数是同步类型（返回void），但调用了BlobClient的异步方法且用.Result/.Wait()强制同步等待，本地调试时极易引发死锁。
• Azurite配置缺失：本地local.settings.json中未明确指定Blob存储的连接配置，导致BlobClient绑定无法正确初始化连接。

解决办法 #

1. 对齐SDK与Runtime版本 #

• 执行func --version查看本地Functions CLI版本，对应匹配Azure.Storage.Blobs NuGet包版本：
  • Functions v4.x：锁定Azure.Storage.Blobs为12.14.x及以上兼容版本，避免自动升级导致的不兼容。
• 手动在项目的.csproj中指定版本：

  <PackageReference Include="Azure.Storage.Blobs" Version="12.14.1" />
  

2. 修复异步代码逻辑 #

将函数改为异步模式，统一使用await调用BlobClient的异步方法，避免阻塞：

[FunctionName("BlobTriggerFunction")]
public async Task Run(
    [BlobTrigger("test-container/{name}", Connection = "AzureWebJobsStorage")] BlobClient blobClient,
    ILogger log)
{
    log.LogInformation($"开始处理Blob: {blobClient.Uri}");
    // 用await调用异步方法，避免同步阻塞
    var blobContent = await blobClient.DownloadContentAsync();
    // 自定义业务逻辑
    log.LogInformation("Blob处理完成");
}

3. 完善本地配置 #

在local.settings.json中明确添加Blob存储连接配置，确保绑定能识别Azurite：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
    "AzureWebJobsBlobStorageConnection": "UseDevelopmentStorage=true"
  }
}

4. 升级本地工具版本 #

• 升级Azurite：执行npm install -g azurite，修复模拟存储服务的API兼容问题。
• 升级Functions CLI：执行npm install -g azure-functions-core-tools@4，确保本地Runtime的稳定性。

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