VS2022升级至17.6.5后发布至IIS出现HTTP 500问题求助

1. 调整Razor运行时编译的环境配置 #

添加Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation包后，默认仅在开发环境生效，若生产环境未做适配会引发依赖缺失：

• 修改Program.cs中的服务注册逻辑，仅在开发环境启用运行时编译，生产环境使用预编译视图：

var builder = WebApplication.CreateBuilder(args);

var mvcBuilder = builder.Services.AddControllersWithViews();

// 仅开发环境启用Razor运行时编译
if (builder.Environment.IsDevelopment())
{
    mvcBuilder.AddRazorRuntimeCompilation();
}

2. 确认发布时的视图编译设置 #

VS2022 17.6.x可能更改了默认发布配置，导致视图未被正确预编译：

• 右键项目→「属性」→「生成」标签页，勾选「在发布时预编译Razor视图」；
• 或直接编辑项目文件（.csproj），添加以下配置强制预编译：

<PropertyGroup>
  <RazorCompileOnPublish>true</RazorCompileOnPublish>
  <MvcRazorCompileOnPublish>true</MvcRazorCompileOnPublish>
</PropertyGroup>

3. 验证IIS的ASP.NET Core模块与Runtime版本 #

VS2022 17.6.x对应更高版本的ASP.NET Core Runtime，IIS环境不匹配会触发500错误：

• 打开IIS管理器，查看目标网站的「模块」，确认AspNetCoreModuleV2已安装；
• 在服务器执行dotnet --list-runtimes命令，检查已安装的ASP.NET Core Runtime版本是否与项目目标框架一致，若不一致则安装对应版本的ASP.NET Core Hosting Bundle；
• 检查网站的web.config，确保托管配置正确，示例：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath="dotnet" arguments=".\YourProject.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
    </system.webServer>
  </location>
</configuration>

4. 排查发布文件完整性与日志 #

• 对比VS2022 17.5.1和17.6.5版本的发布文件，确认Views目录下的.cshtml或预编译.dll文件未缺失；
• 启用stdout日志：将web.config中stdoutLogEnabled设为true，发布后查看logs目录下的日志，获取500错误的具体原因。

5. 修复VS2022版本的发布bug #

部分用户反馈17.6.x存在发布编译bug，可尝试以下操作：

• 清理项目：右键项目→「清理」，删除bin和obj目录；
• 重新生成解决方案：菜单「生成」→「重新生成解决方案」；
• 使用命令行发布：进入项目目录执行dotnet publish -c Release，再部署到IIS；
• 将VS2022升级至17.7.x及以上版本，微软可能已修复该版本的发布问题。

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