如何在Golang中实现HTTP请求Header自定义处理_Golang HTTP Header处理方法_技术教程

Go中自定义HTTP请求Header需在发送前通过req.Header.Set/Add/Del操作，避免修改Host等自动管理字段；常用方法是newRequest后设置，或用自定义RoundTripper全局注入；JSON请求须显式设Content-Type。

在 Go 中自定义 HTTP 请求 Header 非常直接，核心是通过 *http.Request 的 Header 字段（类型为 http.Header，本质是 map[string][]string）进行增、删、改操作。关键在于时机和方式：必须在请求发出前设置，且注意某些 Header（如 Host、Content-Length）由 Go 标准库自动管理，手动设置可能被忽略或引发错误。

使用 http.NewRequest 手动构造并设置 Header

这是最常用、最可控的方式。先创建请求对象，再通过 req.Header.Set() 或 .Add() 添加自定义字段。

Set(key, value)：覆盖该 key 的所有已有值（只保留一个）
Add(key, value)：追加值，允许同一 key 多个值（如多个 Cookie）
Del(key)：删除指定 key 的全部值

示例：

req, err := http.NewRequest("GET", "https://api.example.com/data", nil)
if err != nil {
    log.Fatal(err)
}
req.Header.Set("User-Agent", "MyApp/1.0")
req.Header.Add("Accept", "application/json")
req.Header.Add("X-Request-ID", uuid.New().String())
// 发送
client := &http.Client{}
resp, err := client.Do(req)

通过 http.Client.Transport 自定义全局请求头（适用于复用场景）

如果多个请求需统一添加某些 Header（如认证 token），可包装 RoundTripper，在每次请求前注入 Header。注意不要修改原始请求对象以外的状态。

实现一个自定义 RoundTripper，在 RoundTrip 方法中克隆请求并设置 Header
避免直接修改传入的 *http.Request，应使用 req.Clone(req.Context()) 安全复制

示例（添加固定 Authorization）：

type authTransport struct {
    base http.RoundTripper
    token string
}

func (t *authTransport) RoundTrip(req *http.Request) (*http.Response, error) {
    req = req.Clone(req.Context())
    req.Header.Set("Authorization", "Bearer "+t.token)
    return t.base.RoundTrip(req)
}

// 使用
client := &http.Client{
    Transport: &authTransport{
        base:  http.DefaultTransport,
        token: "your-jwt-token",
    },
}

注意标准库自动处理的 Header 及常见陷阱

Go 的 http.Transport 会在发送前自动设置或覆盖部分 Header，手动设置可能无效甚至出错：

Host：由 URL 解析得出，手动设会被忽略；如需强制指定，应改用 req.Host 字段（非 Header）
Content-Length 和 Transfer-Encoding：由 body 内容自动计算，手动设置易导致请求失败
Connection、Date、User-Agent（默认有值）：可覆盖，但需明确意图
Header key 会自动规范化（如 "content-type" → "Content-Type"），建议用规范形式写 key

发送 JSON 请求时正确设置 Content-Type 和 Body

常见需求是发 POST/PUT JSON，需同时处理 Header 和序列化 Body：

Body 必须是 io.Reader，通常用 bytes.NewReader(data) 或 strings.NewReader(jsonStr)
Content-Type: application/json 必须显式设置（标准库不会自动加）
确保 JSON 数据已正确序列化，且无编码错误

示例：

data := map[string]string{"name": "Alice"}
jsonBytes, _ := json.Marshal(data)

req, _ := http.NewRequest("POST", "https://api.example.com/users", bytes.NewReader(jsonBytes))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer xxx")

resp, _ := http.DefaultClient.Do(req)

基本上就这些。Golang 的 HTTP Header 处理不复杂但容易忽略细节，重点记住：早设置、别碰自动字段、区分 Set/ Add、JSON 要配对 Content-Type —— 掌握这几点，95% 的自定义需求都能稳稳搞定。