ASP.NET Core Web API返回HTTP 429异常：响应头显示200求助

你遇到的问题根源是在ASP.NET Core中直接返回System.Net.Http.HttpResponseMessage不符合当前框架的响应处理逻辑。框架会将这个对象当作普通业务数据序列化到响应体中，同时默认返回200状态码，导致实际响应头的状态码与预期不符。

解决方案1：仅返回429状态码（无响应体） #

如果不需要在响应体中返回额外信息，可以直接使用ASP.NET Core提供的专用结果类：

使用TooManyRequestsResult（ASP.NET Core 3.0+） #

[Route("{route}")]
[HttpPost]
public IActionResult Post([FromBody] dynamic data)
{
    return new TooManyRequestsResult();
}

使用StatusCodeResult（兼容更早版本） #

[Route("{route}")]
[HttpPost]
public IActionResult Post([FromBody] dynamic data)
{
    return new StatusCodeResult(StatusCodes.Status429TooManyRequests);
}

解决方案2：返回429状态码+自定义响应体 #

如果需要同时在响应体中返回429相关的描述信息，推荐以下两种写法：

简洁写法（推荐） #

[Route("{route}")]
[HttpPost]
public async Task<IActionResult> Post([FromBody] dynamic data)
{
    // 可在此添加异步业务逻辑
    var responseContent = new 
    {
        Message = "请求过于频繁，请稍后重试",
        StatusCode = 429,
        ReasonPhrase = "Too Many Requests"
    };
    return StatusCode(StatusCodes.Status429TooManyRequests, responseContent);
}

使用ObjectResult的写法 #

[Route("{route}")]
[HttpPost]
public IActionResult Post([FromBody] dynamic data)
{
    var responseContent = new 
    {
        Message = "请求过于频繁，请稍后重试",
        StatusCode = 429,
        ReasonPhrase = "Too Many Requests"
    };
    return new ObjectResult(responseContent)
    {
        StatusCode = StatusCodes.Status429TooManyRequests
    };
}

核心原理说明 #

ASP.NET Core的MVC/Web API管道专门针对IActionResult（及其派生类型）进行响应处理：

• 返回IActionResult实现类时，框架会直接解析其中的状态码、响应头和响应体信息，生成符合HTTP规范的响应。
• 直接返回HttpResponseMessage是旧版ASP.NET Web API的写法，在ASP.NET Core中会被当作普通对象序列化，无法触发框架的状态码处理逻辑。

内容的提问来源于stack exchange，提问作者now he who must not be named.