.NET7 API中如何正确手动设置HTTP响应状态码与消息？

原方法失效的原因 #

直接操作HttpContext.Response.WriteAsync时未设置ContentType，导致Swagger无法识别响应内容类型，从而抛出提示；同时这种方式绕开了ASP.NET Core的结果处理管道，可能引发后续响应冲突（比如框架还会尝试写入其他内容）。

方法1：使用Results静态类（推荐，.NET 6+极简写法） #

.NET 6及以后引入的Results类适用于控制器场景，提供了各种状态码的快捷方法，同时支持自定义内容：

[HttpGet("custom-status")]
public IResult CustomStatus()
{
    HttpStatusCode targetStatusCode = HttpStatusCode.PaymentRequired;
    string responseMessage = "需要完成支付才能访问该资源";
    
    // 通用状态码返回
    return Results.StatusCode((int)targetStatusCode, responseMessage);
    
    // 常见状态码可使用快捷方法，比如：
    // return Results.BadRequest("参数格式不正确");
    // return Results.NotFound("请求的资源不存在");
}

方法2：使用ObjectResult或特定状态码结果类（传统控制器写法） #

若习惯用IActionResult作为返回类型，可通过ObjectResult封装消息并指定状态码：

[HttpGet("action-result-status")]
public IActionResult ActionResultStatus()
{
    HttpStatusCode targetStatusCode = HttpStatusCode.Forbidden;
    string responseMessage = "您没有访问该资源的权限";
    
    // 自定义状态码+消息
    return new ObjectResult(responseMessage)
    {
        StatusCode = (int)targetStatusCode
    };
    
    // 常见状态码有对应封装类，比如：
    // return new ForbiddenObjectResult("您没有访问权限");
    // return new BadRequestObjectResult("参数错误");
}

方法3：直接操作HttpContext（仅特殊场景使用） #

如果必须直接操作响应流，一定要设置ContentType并确保响应完成：

[HttpGet("direct-context")]
public async Task DirectContextOperation()
{
    HttpStatusCode targetStatusCode = HttpStatusCode.Unauthorized;
    string responseMessage = "请先登录再访问";
    
    HttpContext.Response.StatusCode = (int)targetStatusCode;
    // 必须设置内容类型，让Swagger和客户端正确识别
    HttpContext.Response.ContentType = "text/plain; charset=utf-8";
    await HttpContext.Response.WriteAsync(responseMessage);
    // 主动完成响应，避免后续管道写入内容导致冲突
    await HttpContext.Response.CompleteAsync();
}

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