本文详解 Go 中 http.Response.Header.Get() 返回空字符串的常见原因：开发者误将响应头设置在 *http.Request 上，而未使用 http.ResponseWriter.Header() 设置响应头。
本文详解 go 中 `http.response.header.get()` 返回空字符串的常见原因：开发者误将响应头设置在 `*http.request` 上，而未使用 `http.responsewriter.header()` 设置响应头。
在 Go 的 HTTP 服务开发中，一个高频误区是混淆请求（*http.Request）与响应（http.ResponseWriter）的 Header 操作对象。如示例代码所示，调用 r.Header.Set("Authorization", "responseAuthVal") 实际修改的是入站请求头（即客户端发来的请求），而非服务器要返回给客户端的响应头。因此，当客户端（如 http.DefaultClient）发起请求并调用 res.Header.Get("Authorization") 时，自然无法读取到该字段——因为响应头根本未被设置。
✅ 正确做法是：在处理函数中，通过 w.Header().Set() 显式设置响应头：
mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
// ✅ 正确：设置响应头（将随 HTTP 响应一同发送）
w.Header().Set("Authorization", "responseAuthVal")
// 可选：设置其他标准响应头
w.Header().Set("X-Content-Type-Options", "nosniff")
w.Header().Set("Cache-Control", "no-store")
fmt.Fprintln(w, "OK")
})
⚠️ 注意事项：
- w.Header() 返回的是一个 http.Header 类型（底层为 map[string][]string），其生命周期绑定于当前响应上下文；必须在 w.WriteHeader() 或首次写入响应体前调用 Set() 才能生效（若已写入 body，Go 会自动发送默认状态码 200 和 header，后续再调用 Set() 将被忽略）。
- r.Header 是只读的请求头快照（由服务器解析后填充），不可用于设置响应内容；对它的任何 Set/Add 操作仅影响 r 本地副本，对客户端完全无意义。
- 使用 httptest.NewServer 进行集成测试时，务必确保 handler 内部操作的是 w.Header()，否则测试将无法反映真实行为。
完整修复后的可运行示例：
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/http/httptest"
)
func main() {
mux := http.NewServeMux()
server := httptest.NewServer(mux)
defer server.Close()
mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
// ✅ 正确设置响应头
w.Header().Set("Authorization", "responseAuthVal")
w.Header().Set("X-Request-ID", "req-12345")
fmt.Fprintln(w, "Response body content")
})
req, _ := http.NewRequest("GET", server.URL, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
// ✅ 现在可以正确获取响应头
authHeader := res.Header.Get("Authorization")
reqID := res.Header.Get("X-Request-ID")
fmt.Printf("Authorization=%q\n", authHeader) // 输出: "responseAuthVal"
fmt.Printf("X-Request-ID=%q\n", reqID) // 输出: "req-12345"
body, _ := ioutil.ReadAll(res.Body)
fmt.Printf("Body=%s", string(body)) // 输出: "Response body content\n"
}
总结：Go 的 HTTP 头操作严格区分请求与响应上下文。记住口诀——“r.Header 读请求，w.Header() 写响应”。始终确认 Header 操作目标是 ResponseWriter，才能确保 response.Header.Get() 返回预期值。
