如何用Golang发送HTTP请求使用http.Client自定义请求头

P粉602998670

发布时间：2025-08-17 14:57:01

374人浏览过

来源于php中文网

原创

在 go 语言中，使用 net/http 包可通过 http.newrequest 创建请求，调用 req.header.set 方法设置自定义请求头（如 user-agent、authorization 等），再通过 http.client 发送请求，其中 set 用于单值头部，add 用于多值头部（如 cookie），建议复用 http.client 并设置超时以提升性能和稳定性，发送 post 请求时可结合 strings.newreader 设置请求体并指定 content-type，从而实现完整的 http 交互。

如何用Golang发送HTTP请求使用http.Client自定义请求头

在 Go 语言中，使用

net/http

包可以轻松发送 HTTP 请求。如果你需要自定义请求头（如设置 User-Agent、Authorization 等），可以通过

http.Client

和

http.Request

来实现。下面详细介绍如何操作。

创建带自定义请求头的 HTTP 请求

要发送一个带有自定义请求头的请求，通常步骤如下：

使用
```
http.NewRequest
```
创建请求对象
调用
```
.Header.Set
```
方法设置请求头
使用
```
http.Client
```
发送请求

package main

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

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

    // 2. 设置自定义请求头
    req.Header.Set("User-Agent", "my-custom-agent/1.0")
    req.Header.Set("Authorization", "Bearer your-jwt-token-here")
    req.Header.Set("X-Request-ID", "12345")

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

    // 4. 读取响应内容
    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Printf("状态码: %d\n", resp.StatusCode)
    fmt.Printf("响应体: %s\n", body)
}

常见请求头设置示例

以下是一些常用的请求头设置方式：

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

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

用于 POST JSON 数据。

req.Header.Set("Authorization", "Basic "+base64.StdEncoding.EncodeToString([]byte("user:pass")))

设置 Basic 认证。

```
req.Header.Set("Accept", "application/json")
```
告诉服务器希望接收 JSON 格式响应。

注意：如果某个 Header 需要添加多个值（比如多个

Cookie

），应使用

Add

而不是

Set

：

蓝心千询

蓝心千询是vivo推出的一个多功能AI智能助手

下载

req.Header.Add("Cookie", "session=abc123")
req.Header.Add("Cookie", "user=john")

Set

会覆盖已有值，而

Add

是追加。

复用 http.Client 与超时设置

生产环境中建议复用

http.Client

实例，并设置合理的超时，避免请求无限阻塞：

client := &http.Client{
    Timeout: 10 * time.Second,
}

你也可以进一步自定义

Transport

来控制连接复用、TLS 设置等：

client := &http.Client{
    Transport: &http.Transport{
        MaxIdleConns:        100,
        IdleConnTimeout:     30 * time.Second,
        TLSHandshakeTimeout: 5 * time.Second,
    },
    Timeout: 15 * time.Second,
}

发送 POST 请求并设置 Body 和 Header

如果需要发送带 body 的请求（如 POST），可以这样写：

jsonStr := `{"name": "Alice", "age": 30}`
req, err := http.NewRequest("POST", "https://httpbin.org/post", strings.NewReader(jsonStr))
if err != nil {
    panic(err)
}

req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer your-token")

client := &http.Client{}
resp, err := client.Do(req)