Azure App Service部署.NET Core2.1+Angular应用遇502.5进程失败错误求助

关于是否由Azure平台变更导致的判断 #

很可能与Azure平台的.NET Core运行时环境变更有关。.NET Core 2.1属于已终止支持版本（微软于2021年8月停止所有官方支持），Azure App Service正逐步淘汰旧版本运行时的部署环境，残留的运行时补丁更新或环境清理操作，都可能引发原本正常运行的旧版本应用启动失败。

具体解决思路 #

1. 验证并锁定.NET Core运行时版本 #

• 在Azure门户进入原槽的App Service配置页，查看「常规设置」中的.NET Core版本是否明确设置为2.1。若平台自动升级了运行时，会导致配置与实际环境不匹配。
• 在应用根目录添加global.json文件，强制指定SDK和运行时版本，避免环境自动切换：

  {
    "sdk": {
      "version": "2.1.818"
    }
  }
  

• 确认部署的DLL文件是使用对应2.1版本SDK编译生成的，避免运行时兼容性错误。

2. 排查原槽的环境损坏问题 #

• 重启原槽的App Service，清理进程缓存后再次尝试启动。
• 登录Kudu控制台（https://<你的应用名>.scm.azurewebsites.net），执行dotnet --info命令，对比新槽的输出结果，确认原槽是否缺少.NET Core 2.1的运行时环境。
• 查看Kudu的「日志流」及stdout/stderr日志，获取更详细的启动异常信息，定位具体的错误原因（如依赖缺失、配置错误等）。

3. 对比原槽与新槽的配置差异 #

• 导出原槽和新槽的配置文件进行对比，检查应用设置、连接字符串、环境变量等是否存在不一致：

  az webapp config show --name <应用名> --slot production --resource-group <资源组名> > prod-config.json
  az webapp config show --name <应用名> --slot <新槽名> --resource-group <资源组名> > newslot-config.json
  

• 修复原槽中与新槽不一致的配置项，尤其是可能影响进程启动的关键设置。

4. 手动测试进程启动并排查依赖 #

• 在Kudu控制台的「调试控制台」中，切换到wwwroot目录，手动执行dotnet .\DLLName.dll命令，观察具体的启动错误提示，定位权限问题或依赖缺失。
• 若发现依赖文件缺失，可从运行正常的新槽中复制对应的依赖文件到原槽，验证是否能恢复启动。

5. 升级到受支持的.NET版本（长期解决方案） #

由于.NET Core 2.1已无官方支持，Azure后续会完全移除相关运行时环境，建议将项目升级到.NET 6或更高的LTS版本：

• 升级项目的SDK版本，更新所有NuGet包，确保Angular前端与新的.NET模板兼容。
• 测试升级后的应用，部署到新槽验证正常后，再交换到生产环境，彻底解决平台兼容性问题。

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