如何在Golang中实现HTTP请求Header设置

在Golang中发送HTTP请求并设置Header,需使用net/http包创建*http.Request对象,通过req.Header.Set(key, value)设置单个Header,如User-Agent、Authorization等;若需同一键多个值,应使用Add方法追加;示例包含GET请求设置及响应读取,支持灵活配置Content-Type、Accept等常用Header。

在Golang中发送HTTP请求并设置Header,主要通过net/http包来完成。你可以使用http.Clienthttp.DefaultClient,并在请求对象上手动添加自定义Header信息。

创建请求并设置Header

要设置HTTP请求的Header,先创建一个*http.Request对象,然后使用其Header字段的Set方法添加键值对。

  • 使用http.NewRequest创建请求
  • 调用req.Header.Set(key, value)设置单个Header
  • 可多次调用Set添加多个Header

示例代码:

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    // 创建GET请求
    req, err := http.NewRequest("GET", "https://httpbin.org/headers", nil)
    if err != nil {
        panic(err)
    }

    // 设置Header
    req.Header.Set("User-Agent", "MyApp/1.0")
    req.Header.Set("Authorization", "Bearer token123")
    req.Header.Set("X-Request-ID", "555")

    // 发送请求
    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    // 读取响应
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

设置多个相同Header键

某些场景下需要为同一个Header键设置多个值(如Accept),此时应使用req.Header.Add而不是Set

  • Set:覆盖已有值
  • Add:追加新值,保留原有值

例如:

req.Header.Add("Accept", "application/json")
req.Header.Add("Accept", "text/html")
// 请求中将包含两行 Accept Header

常见Header设置建议

实际开发中,以下Header经常需要设置:

  • Content-Type:用于POST/PUT请求,如application/json
  • Authorization:携带认证信息,如Bearer Token
  • User-Agent:标识客户端身份
  • Accept:声明期望的响应格式

比如发送JSON数据时:

req, _ := http.NewRequest("POST", url, strings.NewReader(jsonStr))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer xxx")
基本上就这些。灵活使用Header.SetHeader.Add,配合http.Client即可满足大多数Header设置需求。