在开发 Web 应用时，我们经常需要处理 HTTP 请求和响应。但你是否遇到过这样的场景：尝试在返回响应数据后修改响应头，却被抛出了异常？这其实源于 HTTP 协议的一条“隐性规则”：响应头必须在响应体之前发送，响应体发送后，响应头就被锁定。
今天，我们将围绕这一知识点展开，揭示这一规则的原理、ASP.NET Core 的实现，以及如何在实际开发中规避问题。
一、什么是 HTTP 响应头与响应体
在 HTTP 协议中，服务器处理客户端请求后，会返回响应，而响应由以下三部分组成：
1. 状态行
HTTP/1.1 200 OK2. 响应头 (Headers)
Content-Type: text/htmlContent-Length: 567
3. 响应体 (Body)：实际的数据内容，比如一段 HTML、JSON，或者文件数据。通常，客户端会先接收状态行和响应头，基于这些信息决定如何解析和处理随后的响应体。
二、HTTP锁定规则 1. HTTP 协议规定： 响应头必须在响应体之前发送。一旦响应体的一部分开始传输，响应头会被“锁定”，无法再修改。
2. 这一规则背后的原因是：
HTTP 是一种流式传输协议。服务器和客户端之间的数据是以块（chunk）为单位传输的。响应头需要最先发送到客户端，以便客户端知道如何处理接下来的数据。一旦响应体的任何部分开始发送，HTTP 数据流已经进入“传输状态”，响应头无法再回溯修改。
例如：
HTTP/1.1 200 OKContent-Type: text/html<html><body>Hello World</body></html>
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("<b>Hello world</b>");try{context.Response.Headers.Append("X-USER", "Bill");}catch (Exception ex){await context.Response.WriteAsync($"<br/><br/>你不能修改Header集合，Body已经发送. Exception: {ex.Message}");}});app.Run();
在复杂的场景下，可以通过检查 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("<b>Hello world</b>");try{if (!context.Response.HasStarted){context.Response.Headers.Append("X-USER", "Bill");}}catch (Exception ex){await context.Response.WriteAsync($"<br/><br/>你不能修改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