Azure函数从.NET6迁移至.NET8后，DevOps CD部署出现Runtime Version错误

可能的原因及对应解决步骤 #

1. DevOps流水线部署包缺失关键文件 #

• 检查构建任务是否生成了完整的.NET Isolated部署包：
  • 确保dotnet publish命令参数正确：dotnet publish --configuration Release --output $(Build.ArtifactStagingDirectory)，同时确认项目文件里的<TargetFramework>net8.0</TargetFramework>、<AzureFunctionsVersion>v4</AzureFunctionsVersion>、<OutputType>Exe</OutputType>配置无误。
  • 验证构建产物里是否有worker.config.json，这个文件是.NET Isolated运行时的核心配置，丢了会直接导致运行时识别失败。
• 如果用Azure DevOps的Azure Functions部署任务，确保用的是最新版本，并且部署参数（比如函数应用名称、部署槽）都正确，防止部署时漏传文件。

2. 流水线部署时意外覆盖了运行时配置 #

• 检查流水线里有没有修改应用设置的步骤（比如Azure App Service Settings任务），看是不是不小心改了FUNCTIONS_EXTENSION_VERSION或FUNCTIONS_WORKER_RUNTIME：
  • 翻流水线日志，确认部署过程中这两个配置有没有被改动，最终要保证FUNCTIONS_EXTENSION_VERSION = "~4"、FUNCTIONS_WORKER_RUNTIME = "dotnet-isolated"。
  • 部署完去Azure门户的函数应用配置页，再核对一遍这两个关键配置，确保没被篡改。

3. 运行环境未正确加载.NET 8 Isolated运行时 #

• 先重启函数应用：部署后运行时可能没完成初始化，重启能强制加载正确版本。
• 检查配置 > 常规设置里的.NET版本是不是**.NET 8 Isolated**，如果流水线部署后被重置了，手动改回来保存，再重启应用。

4. 部署包损坏或权限问题 #

• 在流水线里加个步骤验证包的完整性：
  • 用PowerShell的Get-ChildItem $(Build.ArtifactStagingDirectory)或者Bash的ls $(Build.ArtifactStagingDirectory)列出文件，确认.dll、worker.config.json、host.json这些必要文件都在。
  • 试试本地手动压缩构建产物，然后通过门户部署，如果能正常运行，说明是流水线压缩环节出了问题，调整流水线的压缩步骤。

5. 运行时版本兼容性问题 #

• 把FUNCTIONS_EXTENSION_VERSION从通配符~4改成具体版本4.1036.2.2（就是VS部署后正常的那个版本），避免自动更新到不兼容的运行时版本，改完重启函数应用。

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