ASP.NET Core 知识速递 – Day 9：HTTP响应顺序，先头后尾

在开发 Web 应用时，我们经常需要处理 HTTP 请求和响应。但你是否遇到过这样的场景：尝试在返回响应数据后修改响应头，却被抛出了异常？这其实源于 HTTP 协议的一条“隐性规则”：响应头必须在响应体之前发送，响应体发送后，响应头就被锁定。

今天，我们将围绕这一知识点展开，揭示这一规则的原理、ASP.NET Core 的实现，以及如何在实际开发中规避问题。

一、什么是 HTTP 响应头与响应体
在 HTTP 协议中，服务器处理客户端请求后，会返回响应，而响应由以下三部分组成：

1. 状态行：描述响应的状态，比如：

HTTP/1.1 200 OK

2. 响应头 (Headers)：附带的元信息，用于描述响应体的内容、缓存策略等。比如：

Content-Type: text/html
Content-Length: 567

3. 响应体 (Body)：实际的数据内容，比如一段 HTML、JSON，或者文件数据。通常，客户端会先接收状态行和响应头，基于这些信息决定如何解析和处理随后的响应体。
   二、HTTP锁定规则
4. HTTP 协议规定：
   响应头必须在响应体之前发送。一旦响应体的一部分开始传输，响应头会被“锁定”，无法再修改。
5. 这一规则背后的原因是：

HTTP 是一种流式传输协议。服务器和客户端之间的数据是以块（chunk）为单位传输的。响应头需要最先发送到客户端，以便客户端知道如何处理接下来的数据。一旦响应体的任何部分开始发送，HTTP 数据流已经进入“传输状态”，响应头无法再回溯修改。
例如：
HTTP/1.1 200 OK
Content-Type: text/html
Hello World
在这段响应中：

1. 响应头 Content-Type 必须在 数据之前发送。
2. 如果你试图在 开始发送后再修改 Content-Type，将导致错误。
   三、ASP.NET Core 中的实现

ASP.NET Core 中，HttpResponse 对象负责管理响应的状态行、头部和主体。它遵循 HTTP 协议的规则，当响应体开始发送时，响应头会被标记为只读。
以下是一个简单的示例代码，展示了这一行为：
var app = WebApplication.Create();
app.Run(async context =>
{
context.Response.Headers.Append(“content-type”, “text/html;;charset=utf-8”);
await context.Response.WriteAsync(“Hello world“);
try
{
context.Response.Headers.Append(“X-USER”, “Bill”);
}
catch (Exception ex)
{
await context.Response.WriteAsync($”

你不能修改Header集合，Body已经发送. Exception: {ex.Message}”);
}
});
app.Run();
运行上面代码
图片
HasStarted属性
在复杂的场景下，可以通过检查 Response.HasStarted 来避免错误：

var app = WebApplication.Create();
app.Run(async context =>
{
context.Response.Headers.Append(“content-type”, “text/html;;charset=utf-8”);
await context.Response.WriteAsync(“Hello world“);
try
{
if (!context.Response.HasStarted)
{
context.Response.Headers.Append(“X-USER”, “Bill”);
}
}
catch (Exception ex)
{
await context.Response.WriteAsync($”

你不能修改Header集合，Body已经发送. Exception: {ex.Message}”);
}
});
app.Run();
总结
理解 HTTP 响应头的“锁定规则”对 Web 开发者来说至关重要。它不仅是 HTTP 协议的核心概念，也是编写稳定、高效 Web 应用的前提。在 ASP.NET Core 中，遵循以下几点可以有效避免问题：

在响应体写入之前完成所有响应头的设置。
使用Response.HasStarted 检查响应状态。
提前设计好中间件管道，避免在后期处理中修改响应头。
希望这篇文章能帮助你在开发中避免响应头相关的坑，同时更好地理解 HTTP 和 ASP.NET Core 的响应机制。

源代码地址：
https://github.com/bingbing-gui/AspNetCore-Skill/tree/master/src/aspnetcore-knowledge-point/request-header