将.NET Isolated Azure Function从.NET 6.0升级到.NET 8.0后发布失败求助

核心问题分析 #

你遇到的WorkerExtensions.csproj自动生成、.NET 6文件残留以及function.deps.json中旧引用的问题，本质是NuGet包版本不兼容.NET 8导致的自动生成逻辑异常，加上项目缓存残留引发的冲突。

分步解决方案 #

1. 升级NuGet包到.NET 8兼容版本

当前使用的Microsoft.Azure.Functions.Worker和Sdk版本（2.0.0）属于旧版本，未适配.NET 8。替换为以下稳定兼容版本（可根据官方更新调整为最新版）：

<PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.20.1" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http" Version="3.1.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.16.4" />

注意：Worker和Sdk版本需保持匹配，避免版本不兼容导致的生成异常。

2. 彻底清理项目缓存

残留的.NET 6文件会干扰新的生成过程，执行以下操作：

• 运行命令：dotnet clean
• 手动删除项目根目录下的obj和bin文件夹
• 重启开发工具（如Visual Studio），清除IDE缓存

3. 检查并修正项目配置

确保项目文件中没有残留的.NET 6配置：

<PropertyGroup>
  <TargetFramework>net8.0</TargetFramework>
  <AzureFunctionsVersion>v4</AzureFunctionsVersion>
  <OutputType>Exe</OutputType>
  <!-- 根据部署环境调整RuntimeIdentifier，如linux-x64或win-x64 -->
  <RuntimeIdentifier>win-x64</RuntimeIdentifier>
</PropertyGroup>

无需手动引用Microsoft.Azure.Functions.Worker.Extensions包，该包已拆分到各单独扩展（如Http扩展），由Sdk自动处理。

4. 修正发布流程

• 使用Visual Studio发布时，确认发布配置的目标框架为.NET 8，并取消勾选"保留未使用的文件"选项
• 或使用命令行发布，指定明确参数：

  dotnet publish -c Release -f net8.0 --runtime win-x64 --self-contained true
  

5. 优化临时脚本（可选）

如果需要保留临时解决方案，可将脚本优化为自动清理生成的问题目录：

# Windows PowerShell版本
dotnet clean
dotnet build -c Release -f net8.0
Remove-Item -Path ".\obj\Release\net8.0\WorkerExtensions" -Recurse -Force
dotnet publish -c Release -f net8.0

# Linux/macOS版本
dotnet clean
dotnet build -c Release -f net8.0
rm -rf ./obj/Release/net8.0/WorkerExtensions
dotnet publish -c Release -f net8.0

关于WebJobs的说明 #

WebJobs模式在消费计划下并非不兼容，但需要手动注册触发器，且隔离模式推荐使用官方Worker SDK方案，因此不建议切换。

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