.NET 6预览版Azure Web App出现HTTP Error 500.31错误如何排查

1. 快速排查运行时版本不匹配问题 #

• 进入对应Azure Web App的「高级工具(Kudu)」，点击Go进入管理页面
• 选择顶部导航栏的「Debug console」→「CMD」，执行命令查看已安装的所有.NET运行时：
  dotnet --list-runtimes
• 若输出结果中无你本地开发使用的.NET 6对应版本，即可确认是运行时缺失导致的报错。

2. 运行时版本匹配操作 #

分两种场景处理：

• 本地使用的是正式发布的.NET 6版本：
  进入Web App的「配置」→「常规设置」页，将.NET运行时版本选择为对应版本，保存后站点自动重启即可生效。
• 本地使用的是Visual Studio 2022预览版附带的.NET预览版本：
  Azure官方托管环境默认不安装未正式发布的.NET预览版，需将发布模式调整为独立部署，把对应运行时和应用一起打包发布：
  1. 打开Visual Studio项目的发布配置页，找到对应Azure发布配置文件
  2. 点击「显示所有设置」，将「部署模式」修改为「独立」
  3. 「目标运行时」选择与Web App环境匹配的架构（Windows环境可选win-x64/win-x86，Linux环境可选linux-x64）
  4. 保存配置后重新发布站点即可。

3. 运行时安装路径说明 #

• Windows系统的Azure Web App，.NET运行时默认安装路径为：C:\Program Files\dotnet\shared\Microsoft.NETCore.App\
• Linux系统的Azure Web App，.NET运行时默认安装路径为：/usr/share/dotnet/shared/Microsoft.NETCore.App/
  你可以在Kudu的命令行中进入对应路径，查看已安装的具体版本号。

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