不使用ASP.NET Core Identity时无法修改Cookie认证LoginPath

问题场景 #

参考ASP.NET Core 5的官方实现，搭建了不带Identity的纯Cookie认证逻辑，原默认登录页为Pages/Account/Login.cshtml，需要将认证跳转的登录路径修改为Pages/Index，但参考各类教程修改LoginPath参数后始终不生效，跳转仍指向原登录地址。

分步排查解决 #

• 检查服务注册的参数格式
  纯Cookie认证的配置需要在AddCookie的选项里显式赋值，路径写法的常见错误是最容易导致配置失效的原因：
  正确的写法不需要加Pages/前缀、不需要加文件后缀，因为Razor Pages的路由会自动以Pages目录为根映射对外路径，Pages/Index.cshtml的对外访问路径就是/Index。
  错误写法包括：/Pages/Index、Pages/Index、Index.cshtml，这些写法都会导致路由匹配失败，最终回退到默认的/Account/Login路径。
  参考正确的注册代码：

  services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
      .AddCookie(options =>
      {
          // 路径必须以斜杠开头，和对外访问路径完全一致
          options.LoginPath = "/Index";
          // 同步检查LogoutPath、AccessDeniedPath是否存在配置错误
          options.LogoutPath = "/Account/Logout";
      });
  

• 核对中间件管道的执行顺序
  这是最容易导致配置不生效的原因，ASP.NET Core的中间件是按注册顺序执行的，顺序错误会直接导致认证逻辑读不到正确的路由配置：
  正确的管道执行顺序必须符合以下要求：

  app.UseRouting();
  app.UseAuthentication(); // 认证中间件必须在路由解析完成后、授权逻辑之前执行
  app.UseAuthorization();
  app.MapRazorPages();
  

  常见的顺序错误包括：将UseAuthentication放在UseRouting之前、将认证中间件放在MapRazorPages之后，这类场景下认证跳转逻辑会直接使用框架默认的登录路径，不会读取你自定义的LoginPath配置。
• 排查是否存在配置覆盖
  如果项目中引入了带默认UI的Identity相关包，比如Microsoft.AspNetCore.Identity.UI，这类包会在后台自动注册一套默认的Cookie认证配置，覆盖你手动写的Cookie参数。
  这种场景下需要找到项目里所有注册Cookie认证方案的代码，把每个方案里的LoginPath都同步修改为/Index，避免被默认配置覆盖。
• 核对页面路由是否存在冲突
  打开Pages/Index.cshtml的页头代码，检查@page指令的配置：如果页面上加了自定义路由，比如@page "/custom-login"，那么原/Index路径就会失效，这时候必须把LoginPath的值修改为和自定义路由完全一致的路径，否则跳转时会出现404，看起来就像LoginPath没生效。
• 加日志验证实际生效的配置
  如果以上检查都没发现问题，可以在认证中间件之后加一段临时逻辑，输出当前实际加载的Cookie配置值，确认是不是被其他代码悄悄改成了默认值：

  // 放在UseAuthentication之后
  app.Use(async (context, next) =>
  {
      var configuredLoginPath = context.RequestServices
          .GetRequiredService<IOptionsMonitor<CookieAuthenticationOptions>>()
          .Get(CookieAuthenticationDefaults.AuthenticationScheme)?.LoginPath;
      // 把值输出到调试窗口，核对是否是你设置的/Index
      System.Diagnostics.Debug.WriteLine($"当前生效的LoginPath：{configuredLoginPath}");
      await next();
  });
  

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