在 Go 中向 ResponseWriter 添加响应头时，必须在调用 WriteHeader() 或首次写入响应体前设置头字段；否则头将被忽略，导致如 Content-Type 等设置失效。
在 go 中向 responsewriter 添加响应头时，必须在调用 `writeheader()` 或首次写入响应体前设置头字段；否则头将被忽略，导致如 `content-type` 等设置失效。
Go 的 http.ResponseWriter 是一个惰性写入接口：它不会立即发送 HTTP 响应，而是延迟到首次调用 Write() 或显式调用 WriteHeader() 时才真正写入状态行和响应头。一旦响应头被写入（即“头已提交”），后续对 w.Header() 的任何修改都将被忽略——这正是问题的根本原因。
在原始代码中：
func (s *HTTPServer) getServices(w http.ResponseWriter, req *http.Request) {
w.Header().Set("Content-Type", "application/json") // ❌ 无效：此时头尚未提交，但后续 json.NewEncoder(w).Encode() 会隐式调用 WriteHeader(http.StatusOK)
if err := json.NewEncoder(w).Encode(s.list.GetAllServices()); err != nil {
log.Println("Error encoding: ", err)
http.Error(w, err.Error(), http.StatusInternalServerError)
}
}json.NewEncoder(w).Encode(...) 在编码过程中会自动触发 WriteHeader(http.StatusOK)（若尚未调用），并立即写入默认头（如 Content-Type: text/plain; charset=utf-8）。此时再设置 Content-Type 已无意义——头已被发送。
✅ 正确做法是：所有头设置必须发生在任何响应体写入之前，且显式控制状态码。推荐写法如下：
func (s *HTTPServer) getServices(w http.ResponseWriter, req *http.Request) {
// ✅ 步骤1：设置响应头（必须在此处）
w.Header().Set("Content-Type", "application/json")
w.Header().Set("X-Content-Type-Options", "nosniff")
// ✅ 步骤2：显式写入状态码（可选，但强烈推荐）
w.WriteHeader(http.StatusOK)
// ✅ 步骤3：安全编码响应体
encoder := json.NewEncoder(w)
encoder.SetEscapeHTML(false) // 避免<等转义，提升可读性（按需）
if err := encoder.Encode(s.list.GetAllServices()); err != nil {
log.Println("JSON encode error:", err)
// 注意：此处不能再调用 w.WriteHeader，因为头已提交
http.Error(w, "Internal Server Error", http.StatusInternalServerError)
return
}
}⚠️ 关键注意事项：
- w.Header().Set() 会覆盖同名头；如需追加多个值，使用 w.Header().Add()；
- http.Error() 内部会调用 WriteHeader() 并写入错误响应体，因此它必须在头设置之后、且不应与自定义响应体混用（避免重复写入）；
- 若使用 json.NewEncoder，建议调用 encoder.SetEscapeHTML(false) 防止 HTML 字符转义（尤其返回纯数据时）；
- 开发中可通过 curl -v 或浏览器开发者工具的 Network 标签验证响应头是否生效。
总结：Go 的 HTTP 响应头管理遵循“先设头、再写状态、最后写体”的严格时序。理解 ResponseWriter 的惰性提交机制，是写出健壮 HTTP 处理器的关键基础。
