如何在ASP.NET Core Razor Pages中拆分状态码页面？

完全可行，你可以通过自定义StatusCodePages中间件的逻辑，直接根据状态码匹配对应的Razor Pages页面，既不用重定向（保障SEO），也无需引入MVC控制器，纯Razor Pages方案即可实现需求。

具体实现步骤 #

1. 替换原有的状态码中间件配置
   移除原来的app.UseStatusCodePagesWithReExecute("/Error", "?statusCode={0}");，改用自定义委托的UseStatusCodePages，根据状态码动态指定要渲染的页面：

   app.UseStatusCodePages(async context =>
   {
       var statusCode = context.HttpContext.Response.StatusCode;
       string pagePath;
   
       // 根据状态码匹配对应页面
       switch (statusCode)
       {
           case 401:
               pagePath = "/401";
               break;
           case 403:
               pagePath = "/403";
               break;
           case 404:
               pagePath = "/404";
               break;
           default:
               // 匹配400-599范围内的其他状态码
               if (statusCode >= 400 && statusCode <= 599)
               {
                   pagePath = "/400_599";
               }
               else
               {
                   // 非4xx/5xx状态码，直接跳过处理
                   return;
               }
               break;
       }
   
       // 重新执行指定Razor Page的请求，保留原响应状态码
       context.HttpContext.Request.Path = pagePath;
       await context.Next(context.HttpContext);
   });
   

2. 创建对应的Razor Pages页面
   在/Pages目录下创建以下页面：

   • 401.cshtml（及对应的401.cshtml.cs页面模型）
   • 403.cshtml（及对应的页面模型）
   • 404.cshtml（及对应的页面模型）
   • 400_599.cshtml（及对应的页面模型）

   注意：所有错误页面的页面模型需要添加[AllowAnonymous]特性，避免未授权用户访问时陷入循环：

   [AllowAnonymous]
   public class _401Model : PageModel
   {
       public void OnGet()
       {
       }
   }
   

3. 确保中间件顺序正确
   该自定义状态码中间件需要放在UseExceptionHandler之后、UseRouting之前（非开发环境下），完整的中间件顺序示例：

   if (!app.Environment.IsDevelopment())
   {
       app.UseStatusCodePages(async context =>
       {
           // 上述自定义逻辑
       });
       app.UseExceptionHandler("/Error");
       app.UseHsts();
   }
   
   app.UseHttpsRedirection();
   app.UseStaticFiles();
   
   app.UseRouting();
   
   app.UseAuthentication();
   app.UseAuthorization();
   
   app.MapRazorPages();
   

方案优势 #

• SEO友好：不会触发重定向，原响应状态码（如401、404）会被完整保留，搜索引擎能正确识别页面状态。
• 轻量简洁：纯Razor Pages实现，无需引入MVC控制器或额外依赖。
• 可扩展性强：如果后续需要新增特定状态码的页面，只需在switch分支中添加对应规则即可。

可选优化：配置化映射 #

如果希望更灵活地管理状态码与页面的映射，可以将规则存入appsettings.json：

"StatusCodePageMappings": {
    "401": "/401",
    "403": "/403",
    "404": "/404",
    "Default4xx5xx": "/400_599"
}

然后在中间件中读取配置：

var mappings = app.Configuration.GetSection("StatusCodePageMappings").Get<Dictionary<string, string>>();
var defaultPath = mappings["Default4xx5xx"];

app.UseStatusCodePages(async context =>
{
    var statusCodeStr = context.HttpContext.Response.StatusCode.ToString();
    string pagePath;

    if (mappings.TryGetValue(statusCodeStr, out pagePath))
    {
        // 使用配置的页面路径
    }
    else if (context.HttpContext.Response.StatusCode is >= 400 and <= 599)
    {
        pagePath = defaultPath;
    }
    else
    {
        return;
    }

    context.HttpContext.Request.Path = pagePath;
    await context.Next(context.HttpContext);
});

这样无需修改代码，就能调整状态码对应的页面路径。

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