.NET6升级至.NET7后Blazor Server应用出现HTTP Error 500.31问题排查

• 混淆Blazor Server运行依赖场景：Blazor Server的业务逻辑运行在服务器端，客户端仅需兼容WebAssembly的浏览器即可，不需要安装.NET运行时。你检查的是客户端PC的运行时版本，这和服务器端抛出的错误无关，问题根源在服务器侧。

• 服务器端缺少对应版本的.NET 7.0 ASP.NET Core运行时：虽然客户端安装了.NET 7.0运行时，但服务器端可能未安装或安装的版本与应用目标框架不匹配。确认服务器的C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App目录下，是否存在应用所需的7.0.x版本（比如应用目标是7.0.4，服务器需安装该版本或兼容的补丁版本）。

• 应用发布配置错误：

  • 发布时未将目标框架设置为.NET 7.0，导致应用仍依赖.NET 6.0运行时。检查发布配置文件（Properties/PublishProfiles/*.pubxml）中的<TargetFramework>字段是否为net7.0。
  • 若选择依赖框架部署，服务器需安装对应运行时；若选择自包含部署，需确保发布包中包含完整的.NET 7.0运行时文件，避免遗漏。

• IIS配置异常：

  • IIS的ASP.NET Core模块版本过旧，无法识别.NET 7.0运行时，需更新至支持.NET 7.0的模块版本。
  • 应用程序池的.NET CLR版本设置错误，需改为无托管代码（ASP.NET Core应用为自托管模式，无需IIS托管CLR）。
  • 站点物理路径指向错误或权限不足，IIS应用池身份没有读取发布目录的权限，导致运行时文件无法加载。

• 应用运行时配置文件错误：应用的runtimeconfig.json中可能硬编码了.NET 6.0的运行时版本，强制应用加载旧版本。检查文件中的runtimeOptions配置，确保指向.NET 7.0：

  {
    "runtimeOptions": {
      "tfm": "net7.0",
      "framework": {
        "name": "Microsoft.AspNetCore.App",
        "version": "7.0.4"
      }
    }
  }
  

• 服务器环境变量限制：服务器上的DOTNET_ROLL_FORWARD等环境变量可能被配置为强制使用.NET 6.0运行时，导致应用无法加载.NET 7.0。检查系统或IIS站点的环境变量设置，移除相关限制。

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