迁移Service Fabric .NET Core 3.1应用至.NET 6后UI出现404错误

针对迁移后API正常但MVC UI出现404的情况，可从以下方向逐步排查：

1. 修复.NET 6启动逻辑的兼容性问题 #

你保留了.NET Core 3.1的Startup.cs和Program.cs未做修改，但.NET 6对路由中间件的要求有变化：

• 必须显式添加UseRouting中间件：在.NET 3.1中UseEndpoints会隐式启用路由，而.NET 6需要在Configure方法中显式调用app.UseRouting()，且必须放在UseEndpoints之前：

  public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
  {
      // 其他中间件（如UseStaticFiles、UseAuthentication等）
      app.UseRouting(); // 新增这一行
      // 认证授权中间件
      app.UseEndpoints(endpoints =>
      {
            endpoints.MapControllerRoute(
                   name: "default",
                   pattern: "{controller=Home}/{action=Index}/{id?}");
             endpoints.MapRazorPages();
      });
  }
  

• 确认Program.cs正确集成Service Fabric：检查CreateHostBuilder中是否添加了Service Fabric集成配置，确保Web主机能正确识别Service Fabric环境：

  public static IHostBuilder CreateHostBuilder(string[] args) =>
      Host.CreateDefaultBuilder(args)
          .ConfigureWebHostDefaults(webBuilder =>
          {
              webBuilder.UseStartup<Startup>();
              // 确保添加Service Fabric集成
              webBuilder.UseServiceFabricIntegration(options => 
                  options.ServiceFabricIntegrationOptions = ServiceFabricIntegrationOptions.None);
          });
  

2. 验证Service Fabric服务配置与状态 #

• 检查ServiceManifest.xml端点配置：确认UI服务的端口、协议配置正确，无拼写错误：

  <Endpoint Name="ServiceEndpoint" Protocol="https" Port="30000" />
  

• 通过Service Fabric Explorer排查服务状态：访问https://localhost:19080，查看UI服务的健康状态、部署节点，检查是否有启动失败的日志信息（在服务的"Logs"标签下查看实时日志）。
• 确认服务部署完整性：检查ApplicationManifest.xml中是否正确包含UI服务的部署节点配置，确保本地调试时服务已成功部署到集群。

3. 检查MVC控制器与视图的有效性 #

• 确认HomeController与视图存在：验证HomeController类存在，且Index方法正确返回View()；同时确认Views/Home/Index.cshtml文件路径正确，无缺失或命名错误。
• 确认MVC服务已注册：检查Startup.cs的ConfigureServices方法中是否注册了MVC相关服务：

  services.AddControllersWithViews();
  services.AddRazorPages(); // 若项目使用Razor Pages需保留
  

4. 排查中间件顺序与静态文件配置 #

• 调整中间件顺序：确保UseStaticFiles（若依赖静态资源）、UseRouting、UseEndpoints的顺序正确，静态文件中间件需放在路由之前：

  app.UseStaticFiles();
  app.UseRouting();
  // 认证、授权中间件
  app.UseEndpoints(...);
  

• 临时禁用认证中间件测试：若UI配置了Azure AD认证，可暂时注释认证相关中间件，测试是否能正常访问首页，排除认证拦截导致的隐性404。

5. 确认项目目标框架与包配置 #

• 验证目标框架设置：检查UI项目文件中TargetFramework已改为net6.0：

  <TargetFramework>net6.0</TargetFramework>
  

• 清理缓存重新构建：删除项目的bin、obj文件夹，清理Service Fabric本地集群缓存后，重新构建部署项目，排除缓存导致的异常。

内容的提问来源于stack exchange，提问作者Ousmane D.