如何正确使用 Go 的 http.NewRequest 方法设置请求头-Golang-PHP中文网

如何正确使用 Go 的 http.NewRequest 方法设置请求头

本文详解 Go 标准库中 http.NewRequest 的正确用法，重点澄清常见误区（如误将 headers 传入 body 参数），并演示如何安全、规范地设置 HTTP 请求方法、URL 和请求头。

本文详解 go 标准库中 `http.newrequest` 的正确用法，重点澄清常见误区（如误将 headers 传入 body 参数），并演示如何安全、规范地设置 http 请求方法、url 和请求头。

在 Go 的 net/http 包中，http.NewRequest 是构建 HTTP 请求对象的核心函数，其函数签名如下：

func NewRequest(method, url string, body io.Reader) (*Request, error)

关键点在于第三个参数 body 的类型是 io.Reader，而非 map[string]string 或其他任意结构体。
初学者常误以为该参数用于传递请求头（headers），但这是不正确的——body 仅用于携带请求体数据（如 POST/PUT 请求的 JSON、表单或文件内容），而请求头必须通过返回的 *http.Request 对象的 Header 字段单独设置。

✅ 正确做法：分两步完成请求构建

调用 http.NewRequest 时，为 body 传入 nil（无请求体）或合法的 io.Reader 实例；
再通过 req.Header.Add() 或 req.Header.Set() 设置请求头。

以下是一个完整、可运行的 DELETE 请求示例：

使用Go语言搭建家庭相册系统-相关课件

下载

package main

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

func main() {
    url := "https://api.example.com/v1/resource/123"

    // 第一步：创建请求（DELETE 方法，无请求体 → body = nil）
    req, err := http.NewRequest("DELETE", url, nil)
    if err != nil {
        panic(fmt.Sprintf("failed to create request: %v", err))
    }

    // 第二步：设置请求头（注意：键名会自动标准化为 Title Case，如 "authorization" → "Authorization"）
    req.Header.Add("Authorization", "Bearer 1432536546")
    req.Header.Set("Content-Type", "application/json") // Set 覆盖同名头，Add 允许重复

    // 可选：验证头是否生效
    fmt.Printf("Headers set: %+v\n", req.Header)

    // 后续可使用 http.DefaultClient.Do(req) 发送请求
    // resp, err := http.DefaultClient.Do(req)
}

⚠️ 注意事项与最佳实践

Header 键名自动标准化：Go 会将 "authorization" 自动转为首字母大写的 "Authorization"，因此无需手动格式化；但建议直接使用标准写法（如 "Authorization"、"Content-Type"）以提高可读性。
Set() vs Add()：
- req.Header.Set(key, value)：清除所有同名 Header 后设置新值（适用于唯一性头，如 Content-Type）；
- req.Header.Add(key, value)：追加值（适用于允许多值的头，如 Cookie）。
Body 必须是 io.Reader：若需发送 JSON 数据，应使用 strings.NewReader(jsonStr) 或 bytes.NewBuffer([]byte(jsonStr))；空请求体请始终使用 nil。
URL 校验：确保 url 字符串格式合法（含协议，如 https://），否则 NewRequest 会返回错误。
不要忽略错误：http.NewRequest 在 URL 解析失败或 method 不合法时会返回非 nil error，务必检查。