首页 > Golang > Go教程

Golang设置自定义HTTP请求头方法

时间：2025-11-05 10:40:33 397浏览收藏

大家好，今天本人给大家带来文章《Golang自定义HTTP请求头设置方法》，文中内容主要涉及到，如果你对Golang方面的知识点感兴趣，那就请各位朋友继续看下去吧~希望能真正帮到你们，谢谢！

在Golang中发送HTTP请求并自定义Header，需通过net/http包创建请求后调用req.Header.Set方法设置，如添加User-Agent、Authorization等；可使用http.NewRequest初始化请求，再修改Header，注意Set会覆盖原有值而Add为追加；对于重复使用的Header，可通过封装函数或自定义RoundTripper实现复用，确保每次请求自动携带所需头信息。

如何在Golang中实现HTTP请求Header自定义

在Golang中发送HTTP请求并自定义Header，可以通过net/http包灵活实现。你可以在请求前手动设置Header字段，适用于添加认证信息、内容类型、用户代理等场景。

使用 http.NewRequest 设置自定义Header

通过 http.NewRequest 创建请求后，使用返回的 *http.Request 对象调用 Header.Set 方法添加或修改Header：

创建 GET 或 POST 请求对象
调用 request.Header.Set("Key", "Value") 添加自定义头
使用 http.DefaultClient.Do 发送请求

示例代码：

package main

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

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

    // 自定义Header
    req.Header.Set("User-Agent", "MyClient/1.0")
    req.Header.Set("Authorization", "Bearer token123")
    req.Header.Set("X-Custom-Header", "custom-value")

    // 发送请求
    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如 User-Agent 默认由Go设置，如果你想覆盖它，必须显式调用 Set 方法。注意不要使用 Add，因为它会追加而不是替换。

Set(key, value)：设置单个值，已存在则覆盖
Add(key, value)：追加值，用于支持多值Header（如 Cookie）

例如，强制指定 Content-Type：

req.Header.Set("Content-Type", "application/json")

为所有请求统一设置 Header（使用 Client 或 RoundTripper）

如果你有多个请求需要携带相同Header（如鉴权Token），可以封装一个自定义的 http.Client 或中间件式的 RoundTripper。

简单做法：封装公共Header设置函数：

func addCommonHeaders(req *http.Request) {
    req.Header.Set("Authorization", "Bearer your-token")
    req.Header.Set("User-Agent", "go-client/1.0")
}

// 使用时
req, _ := http.NewRequest("GET", url, nil)
addCommonHeaders(req)

进阶做法：使用自定义 Transport 自动注入Header：

type headerTransport struct {
    Transport http.RoundTripper
}

func (t *headerTransport) RoundTrip(req *http.Request) (*http.Response, error) {
    req.Header.Set("X-Request-ID", "12345")
    req.Header.Set("Authorization", "Bearer auto-token")
    return t.Transport.RoundTrip(req)
}

// 使用
client := &http.Client{
    Transport: &headerTransport{
        Transport: http.DefaultTransport,
    },
}

基本上就这些。自定义Header的关键是获取到 *http.Request 实例后，在发送前修改其 Header 字段。根据实际需求选择直接设置或封装复用。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~