Azure Functions从3x升级到4x后出现AZFD0005配置构建错误求助

核心问题定位 #

加载的Microsoft.Azure.WebJobs.Extensions.Storage版本为4.0.2.0，低于Functions 4x要求的最低版本4.0.4.0，导致启动配置构建失败。

分步修复操作 #

• 强制更新项目NuGet包
  直接在项目的.csproj文件中明确指定包版本，避免依赖解析偏差：

  <PackageReference Include="Microsoft.Azure.WebJobs.Extensions.Storage" Version="4.0.4" />
  

  执行dotnet restore和dotnet build确保依赖正确更新，再重新部署。

• 清理部署残留文件
  旧版本的扩展文件可能残存在Azure App Service的文件系统中，通过Kudu控制台（高级工具）删除site/wwwroot/bin目录下的旧扩展DLL，再重新部署新版本。

• 验证hosts.json配置正确性
  确保hosts.json中扩展版本指定格式正确，针对isolated模式需配置在extensionBundle内：

  {
    "version": "2.0",
    "extensionBundle": {
      "id": "Microsoft.Azure.Functions.ExtensionBundle",
      "version": "[4.0.0, 5.0.0)"
    }
  }
  

  若单独指定Storage扩展，需确认格式无误：

  {
    "extensions": {
      "blobs": {
        "extensionVersion": "4.0.4"
      },
      "queues": {
        "extensionVersion": "4.0.4"
      }
    }
  }
  

• 检查应用设置中的扩展版本覆盖
  确认App Service的应用设置中没有设置AzureWebJobsStorageExtensionVersion之类的环境变量强制指定旧版本，若有则删除该设置。

• 重新发布时使用干净部署
  在部署命令中添加--clean参数，确保部署时替换所有旧文件：

  dotnet publish --configuration Release --output ./publish --clean
  

验证修复结果 #

部署完成后，通过Kudu控制台查看site/wwwroot/bin下的Microsoft.Azure.WebJobs.Extensions.Storage.dll版本是否为4.0.4.0及以上；重启函数应用后查看启动日志，确认AZFD0005错误消失；最后测试Logic App调用是否正常返回。

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