ASP.NET Razor Pages如何定义自定义BadRequest HTML错误页

BadRequest() 方法传入字符串时默认返回纯文本响应，是因为该重载生成的BadRequestObjectResult会将字符串类型内容默认以text/plain格式输出，不会解析HTML标签。要返回格式化的HTML内容甚至完整布局的错误页，有三种常用实现方式：

1. 简单HTML片段直接返回 #

如果只需要简单的格式化提示，不需要复用站点全局布局，可以手动设置响应状态码为400，通过Content方法返回指定text/html类型的内容：

public async Task<IActionResult> OnGetAsync(string payload) {
  if (validatePayload(payload)) 
  {
      Response.StatusCode = StatusCodes.Status400BadRequest;
      // 直接写需要的HTML内容即可
      return Content("<h2>Your request was badly formatted.</h2><p>请检查请求参数后重试</p>", "text/html; charset=utf-8");
  }
  return Page();
}

2. 返回自定义Razor错误页 #

如果需要和站点其他页面保持一致的布局样式，推荐单独创建错误页：

• 先在Pages目录下新建BadRequest.cshtml及对应的PageModel，可正常复用_Layout布局写完整HTML结构
• 在页面逻辑中手动设置状态码为400，避免返回200状态不符合HTTP语义：

// BadRequest页对应的PageModel代码
public class BadRequestModel : PageModel
{
    public string? ErrorMsg { get; set; }
    public void OnGet(string msg)
    {
        // 核心：设置响应状态码为400
        Response.StatusCode = StatusCodes.Status400BadRequest;
        ErrorMsg = msg;
    }
}

业务逻辑中跳转传参即可：

if (validatePayload(payload)) 
{
    return RedirectToPage("/BadRequest", new { msg = "Your request was badly formatted." });
}

3. 全局配置统一错误处理 #

如果项目中多处需要返回400响应，可以在Program.cs中配置全局状态码处理中间件，不需要每个接口单独写错误页逻辑：

// 注意要放在静态文件、路由等中间件之前注册
app.UseStatusCodePagesWithReExecute("/Error/{0}");

配置完成后，业务代码只需要正常写return BadRequest()，框架会自动将400请求路由到统一的Error页，你可以在Error页中针对不同状态码写对应的HTML展示逻辑，实现全站错误风格统一。

注意：不要直接把带HTML标签的字符串传入BadRequest()方法，该方法不会解析HTML，会把标签作为纯文本原样输出。

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