.NET 6中ASP.NET Core Razor Pages编译异常求助

核心原因 #

dotnet build与dotnet publish的默认行为差异是问题根源：

• Visual Studio运行项目时，处于开发环境，会直接读取项目目录下的原始.cshtml文件，再加上你启用了Razor运行时编译，所以UI显示正常。
• dotnet build默认仅编译后端代码，不会将.cshtml、静态资源等文件复制到bin/Debug/net6.0目录；而dotnet publish会自动处理视图文件的复制/预编译，同时打包静态资源，所以发布后的目录能正常渲染UI。

具体解决步骤 #

1. 修改.csproj配置，让Build时复制视图与静态资源 #

你之前配置的CopyToPublishDirectory仅在发布时生效，需要替换为CopyToOutputDirectory才能让dotnet build把文件复制到输出目录：

<ItemGroup>
  <!-- 复制Pages目录下的所有cshtml文件 -->
  <None Update="Pages\**\*.cshtml">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
  <!-- 复制Identity区域的cshtml文件 -->
  <None Update="Areas\Identity\Pages\**\*.cshtml">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
  <!-- 复制wwwroot下的静态资源（解决无样式问题） -->
  <None Update="wwwroot\**\*">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>

编译配置可以简化，.NET 6中RazorCompileOnBuild已被MvcRazorCompileOnBuild替代，无需重复配置：

<PropertyGroup>
  <!-- 开启构建时的Razor预编译 -->
  <MvcRazorCompileOnBuild>true</MvcRazorCompileOnBuild>
  <!-- 发布时同样启用预编译（可选） -->
  <MvcRazorCompileOnPublish>true</MvcRazorCompileOnPublish>
</PropertyGroup>

2. 调整Razor运行时编译的生效范围 #

你在Program.cs中启用的AddRazorRuntimeCompilation()默认仅在开发环境生效。如果需要在非开发环境也允许运行时编译（比如Debug输出目录运行时），可以显式配置：

var builder = WebApplication.CreateBuilder(args);

// 强制启用运行时编译，并指定视图文件的读取路径
builder.Services.AddRazorPages()
    .AddRazorRuntimeCompilation(options =>
    {
        options.FileProviders.Add(new PhysicalFileProvider(
            Path.Combine(builder.Environment.ContentRootPath, "Pages")));
        options.FileProviders.Add(new PhysicalFileProvider(
            Path.Combine(builder.Environment.ContentRootPath, "Areas/Identity/Pages")));
    });

// 其他配置...
app.MapRazorPages();
app.Run();

更规范的做法是通过环境变量控制，仅在开发环境启用运行时编译，生产环境用预编译：

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddRazorPages().AddRazorRuntimeCompilation();
}
else
{
    builder.Services.AddRazorPages();
}

3. 彻底清理缓存并重建项目 #

执行以下命令清除旧的构建缓存，确保新配置生效：

dotnet clean
dotnet restore
dotnet build -c Debug

完成后检查bin/Debug/net6.0目录，确认Pages、Areas/Identity/Pages、wwwroot文件夹已存在。

4. 验证预编译配置（可选） #

如果希望Razor视图被预编译到程序集中（无需复制原始.cshtml文件），确保已安装对应的NuGet包：

dotnet add package Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation --version 6.0.25

预编译后的视图代码会嵌入到程序集，运行时无需读取外部.cshtml文件，但运行时编译功能依赖此包。

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