.NET 8+VS2022环境下IIS中Razor Pages运行时编译失效求助

针对Windows 11 + IIS 10 + .NET 8环境下Razor Pages运行时编译不生效的问题，按以下步骤排查修复：

1. 禁用Razor视图预编译（关键） #

.NET 8默认会在发布时预编译Razor视图为静态程序集，直接覆盖运行时编译逻辑。需在项目文件（.csproj）中添加以下配置：

<PropertyGroup>
  <!-- 禁用发布时预编译Razor视图 -->
  <MvcRazorCompileOnPublish>false</MvcRazorCompileOnPublish>
  <!-- 确保cshtml文件随发布复制，且保留最新版本 -->
  <CopyRazorFilesToPublishDirectory>PreserveNewest</CopyRazorFilesToPublishDirectory>
</PropertyGroup>

2. 确认运行时编译服务配置 #

在Program.cs中确保运行时编译服务全局启用，无环境限制：

var builder = WebApplication.CreateBuilder(args);

// 添加Razor Pages并启用运行时编译
builder.Services.AddRazorPages()
    .AddRazorRuntimeCompilation(options =>
    {
        // 显式指定视图文件目录，确保服务器端修改被检测
        options.FileProviders.Add(new PhysicalFileProvider(
            Path.Combine(builder.Environment.ContentRootPath, "Pages")));
    });

var app = builder.Build();

// 常规中间件配置
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();
app.MapRazorPages();

app.Run();

3. 调整Visual Studio发布配置 #

在VS发布向导的文件发布选项中：

• 取消勾选「预编译发布」，或若勾选则禁用「启用 Razor 视图预编译」选项
• 确认「保留现有文件」未勾选，避免旧预编译文件残留

4. IIS站点配置优化 #

• 应用程序池设置：确保.NET CLR版本为「无托管代码」，托管管道模式为「集成」
• 缓存禁用：在站点的web.config中添加以下配置，防止IIS缓存cshtml文件：

<system.webServer>
  <staticContent>
    <clientCache cacheControlMode="DisableCache" />
  </staticContent>
  <caching enabled="false" />
</system.webServer>

• 文件权限：确保IIS应用程序池身份（默认是IIS AppPool\你的站点池名称）对发布目录下的Pages文件夹拥有读取和写入权限（运行时编译需要生成临时文件）

5. 验证操作 #

发布站点到IIS后：

1. 修改服务器上Pages目录下的任意.cshtml文件
2. 直接刷新前端页面，无需重启站点或应用程序池，即可看到修改效果

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