Azure Windows Web App部署.NET 3.1 Razor新页面后返回404错误

• 确认部署文件是否存在
  登录Azure门户，进入目标Web App，打开「高级工具」>「Kudu」，在调试控制台的CMD窗口里导航到site\wwwroot目录，检查newpage.cshtml是否存在。如果没有，说明部署时该文件没被传到服务器。

• 检查项目文件的复制设置
  本地项目里右键点击newpage.cshtml，打开属性面板，把「复制到输出目录」设为「如果较新则复制」或「始终复制」。也可以直接打开.csproj文件，确认有以下配置条目：

  <Content Include="wwwroot\newpage.cshtml">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
  

• 验证路由配置正确性
  打开Startup.cs，确认服务配置里有services.AddRazorPages()，端点配置里包含endpoints.MapRazorPages()，确保Razor页面的默认路由规则生效，没有被自定义路由覆盖。示例代码：

  public void ConfigureServices(IServiceCollection services)
  {
      services.AddRazorPages();
  }
  
  public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
  {
      // 其他中间件（比如静态文件、错误处理）配置
      app.UseEndpoints(endpoints =>
      {
          endpoints.MapRazorPages();
      });
  }
  

• 清理后重新部署
  在Visual Studio里右键项目，先选「清理」，再选「生成」。重新执行Web Deploy部署时，勾选「移除目标上的额外文件」，保证服务器文件和本地完全同步。

• 核对Azure运行环境设置
  进入Azure门户的Web App>「配置」>「常规设置」，确认.NET版本是.NET Core 3.1，运行栈选的是「.NET Core」，避免环境不匹配导致页面无法被识别。

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