在go的net/http包中，响应头必须在调用writeheader()之前设置完毕；一旦writeheader()被调用（或隐式触发），响应头即被写入并发送至客户端，后续对header()的修改将被忽略。
在go的net/http包中，响应头必须在调用writeheader()之前设置完毕；一旦writeheader()被调用（或隐式触发），响应头即被写入并发送至客户端，后续对header()的修改将被忽略。
在Go Web开发中，http.ResponseWriter 的行为遵循 HTTP 协议的底层传输逻辑：响应由状态行、响应头和响应体三部分组成，且必须按序一次性写出。w.WriteHeader(statusCode) 的作用不仅是设置HTTP状态码，更关键的是——它会触发响应头的实际写入（flush）。一旦响应头被写出，后续再调用 w.Header().Set() 或 w.Header().Add() 将完全无效，因为底层连接已开始发送数据（甚至可能已完成头部传输）。
✅ 正确写法：先设头，再写状态，最后写体
func handler(w http.ResponseWriter, r *http.Request) {
// 1. 设置所有响应头（Content-Type、X-Request-ID等）
w.Header().Set("Content-Type", "application/json")
w.Header().Set("X-Frame-Options", "DENY")
// 2. 显式写入状态码（此时才真正写入响应头）
w.WriteHeader(http.StatusCreated)
// 3. 写入响应体（body）
js := []byte(`{"id":123,"message":"created"}`)
w.Write(js)
}
❌ 错误写法：状态码前置导致头丢失
// ⚠️ 危险！以下代码中 Content-Type 永远不会生效
w.WriteHeader(http.StatusCreated) // ← 响应头此刻已写入并发送
w.Header().Set("Content-Type", "application/json") // ← 此行被忽略！
w.Write(js)
? 补充说明与注意事项
-
隐式 WriteHeader()：若未显式调用
w.WriteHeader()，首次调用w.Write()时会自动以http.StatusOK (200)补充状态码并写入响应头。因此，即使不显式调用WriteHeader()，也必须确保所有 Header 设置在第一次w.Write()之前完成。 -
Header 修改限制：
w.Header()返回的是一个可修改的http.Header映射，但其修改仅在响应头尚未写出时有效；写出后所有变更均失效（无报错，静默忽略）。 -
最佳实践建议：
- 统一在处理逻辑末尾、写入响应体前集中设置所有 Header；
- 使用中间件预设通用头（如 CORS、Security Headers）；
- 避免在
WriteHeader()后尝试修改 Header —— 这不是 bug，而是设计使然，保障 HTTP 协议的严谨性与流式传输的可靠性。
理解这一机制，是写出健壮、符合 HTTP 规范的 Go Web 服务的关键一步。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
