在 go 中通过 http.responsewriter 设置响应头时，必须在调用 writeheader() 或首次写入响应体前完成；否则 headers 将被忽略，导致如 content-type 不生效等常见问题。
在 go 中通过 http.responsewriter 设置响应头时，必须在调用 writeheader() 或首次写入响应体前完成；否则 headers 将被忽略，导致如 content-type 不生效等常见问题。
Go 的 http.ResponseWriter 是一个惰性写入器：它不会立即发送 HTTP 响应，而是等待首次调用 Write() 或显式调用 WriteHeader() 后才真正“提交”状态码和响应头。一旦响应头被提交（即底层 HTTP 连接已发送状态行和 headers），后续对 w.Header() 的任何修改都将被静默忽略——这正是你遇到 Content-Type 始终为默认 text/plain; charset=utf-8 的根本原因。
在你的原始代码中：
func (s *HTTPServer) getServices(w http.ResponseWriter, req *http.Request) {
w.Header().Set("Content-Type", "application/json") // ✅ 此处看似正确
if err := json.NewEncoder(w).Encode(s.list.GetAllServices()); err != nil { // ❌ Encode() 内部会隐式调用 WriteHeader(http.StatusOK)
log.Println("Error encoding: ", err)
http.Error(w, err.Error(), http.StatusInternalServerError)
}
}json.Encoder.Encode() 在序列化开始时会自动调用 w.WriteHeader(http.StatusOK)（若尚未调用），此时响应头已被锁定，你之前设置的 Content-Type 就失效了。
✅ 正确做法是：所有 header 操作必须严格位于任何响应写入操作之前，包括 Encode()、Write() 或 http.Error()。推荐写法如下：
func (s *HTTPServer) getServices(w http.ResponseWriter, req *http.Request) {
// Step 1: 设置响应头（必须在 WriteHeader 或 Encode 前）
w.Header().Set("Content-Type", "application/json")
w.Header().Set("X-Content-Generated", "dnsdock-v1")
// Step 2: 显式写入状态码（可选，但显式更清晰）
w.WriteHeader(http.StatusOK)
// Step 3: 执行编码（此时 headers 已锁定，Encode 不会再触发 WriteHeader）
encoder := json.NewEncoder(w)
encoder.SetEscapeHTML(false) // 避免 HTML 实体转义（如 < → \u003c）
if err := encoder.Encode(s.list.GetAllServices()); err != nil {
log.Printf("JSON encode error: %v", err)
// 注意：此处不能再调用 w.Header()，因响应已开始传输
http.Error(w, "Internal server error", http.StatusInternalServerError)
return
}
}⚠️ 注意事项：
- w.Header().Set() 会覆盖同名 header；若需追加多个值（如多个 Cache-Control），请使用 w.Header().Add()；
- http.Error() 会自动调用 WriteHeader() 并写入错误体，因此它必须是响应流程的终点，不能在其后继续写入；
- 使用 encoder.SetEscapeHTML(false) 可提升 JSON 可读性（尤其含 HTML 片段时），但需确保内容安全；
- 调试技巧：可在 w.Header().Set(...) 后添加 log.Printf("Headers: %+v", w.Header())（注意——仅在未提交前有效，实际运行中该日志可能不反映最终发送值）；更可靠的方式是用 curl -i 或 Postman 查看真实响应。
掌握这一“headers 必须前置”的规则，是编写健壮 Go HTTP 服务的关键基础。
