Golang HTTP请求Header处理与自定义示例

使用net/http可自定义HTTP请求Header，如设置User-Agent、Authorization和Content-Type。通过req.Header.Set添加单值头，适用于认证、数据类型声明等场景，并可通过封装函数复用通用Header配置。

在Go语言中发送HTTP请求时，Header的处理是一个常见且重要的操作。正确设置请求头不仅能帮助服务端识别客户端信息，还能传递认证参数、内容类型等关键数据。本文将介绍如何使用标准库net/http来处理和自定义HTTP请求的Header，并给出实用示例。

设置基础请求Header

使用http.Client或http.NewRequest可以创建自定义请求并添加Header。通过请求对象的Header字段（类型为http.Header，本质是map[string][]string），可设置各种头字段。

以下是一个添加User-Agent和Accept的例子：

req, err := http.NewRequest("GET", "https://api.example.com/data", nil)
if err != nil {
    log.Fatal(err)
}

req.Header.Set("User-Agent", "my-go-client/1.0")
req.Header.Set("Accept", "application/json")

client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

添加认证相关Header

很多API需要身份验证，常见的如Bearer Token或API Key。这类信息通常放在Authorization头中。

立即学习“go语言免费学习笔记（深入）”；

例如，使用Bearer Token：

req.Header.Set("Authorization", "Bearer your-jwt-token-here")

如果是API Key，可能这样设置：

req.Header.Set("X-API-Key", "your-api-key-12345")

注意：具体字段名（如X-API-Key）由服务端定义，需参考对应API文档。

AI Sofiya

一款AI驱动的多功能工具

109

查看详情

设置请求内容类型与编码

当发送POST或PUT请求携带数据时，必须正确设置Content-Type，让服务端知道如何解析请求体。

常见类型包括：

• application/json：用于JSON数据
• application/x-www-form-urlencoded：表单提交
• multipart/form-data：文件上传

示例：发送JSON数据

data := `{"name": "Alice", "age": 30}`
req, _ := http.NewRequest("POST", "https://api.example.com/users", strings.NewReader(data))
req.Header.Set("Content-Type", "application/json")

修改默认Header或复用配置

若需多次发送相似请求，可封装一个函数来统一设置Header：

func newRequest(method, url, token string) (*http.Request, error) {
    req, err := http.NewRequest(method, url, nil)
    if err != nil {
        return nil, err
    }

    req.Header.Set("User-Agent", "go-app/1.0")
    req.Header.Set("Authorization", "Bearer "+token)
    req.Header.Set("Accept", "application/json")

    return req, nil
}

这样每次创建请求时就能自动带上通用Header，减少重复代码。

基本上就这些。Golang的net/http包对Header操作提供了清晰直观的接口，合理使用Set、Add方法即可满足大多数场景需求。关键是根据目标API的要求设置正确的字段和值。不复杂但容易忽略细节，比如大小写敏感性和多值合并规则。

以上就是Golang HTTP请求Header处理与自定义示例的详细内容，更多请关注php中文网其它相关文章！