Go / 系统课时
拆解 URL、Header 与消息体
拆解 URL、Header 与消息体
一条 HTTP 请求由目标地址、消息元数据和消息体共同组成。本篇用一条可直接运行的 Go 请求拆解 scheme、host、path、query、Header 与 Body,并说明服务端解析时最容易混淆的边界。
学习目标
- 能区分 scheme、host、path、query、Header 与 Body 的职责
- 能理解
Content-Type、Accept与 URL 编码对请求解析的影响 - 能用 Go 标准库拆解并验证一条 HTTP 请求
URL 决定目标与资源
以 https://api.example.com/v1/orders?dry_run=true&tag=go 为例,scheme 是 https,host 是 api.example.com,path 是 /v1/orders,query 是 dry_run=true&tag=go。scheme 描述协议,host 定位目标主机,path 通常参与路由匹配,query 适合携带筛选、分页、排序或开关等参数。
query 属于 URL,需要按 URL 编码规则传输。保留字符和非 ASCII 内容应正确转义;使用表单式 query 编码时,空格还常被编码为 +。在 Go 中应通过 url.URL.Query() 获取已经解析并解码的参数,不要手工切割 ?、& 与 =,否则容易破坏重复参数和转义后的值。
在服务端处理常见的 origin-form 请求时,主机名通常从 Request.Host 获取,而 Request.URL.Host 往往为空;HTTPS 的 scheme 也通常依据 TLS 状态或可信反向代理提供的信息判断。因此,客户端看到的完整 URL 并不会逐字段原样出现在服务端请求对象中。

Header 描述消息元数据
Header 是字段名大小写不敏感的元数据集合,同一个字段也可以拥有多个值。它描述这次交互应如何被处理,而不是用来承载大块业务数据。
Content-Type 描述当前消息体的媒体类型,例如 application/json 表示 Body 应按 JSON 解析;Accept 描述客户端希望收到的响应类型,用于内容协商。前者说明“我发送的是什么”,后者说明“我希望你返回什么”,方向不同,不能互相替代。
Body 承载需要解码的数据
Body 本质上是字节流,可以承载 JSON、表单、图片或其他数据。服务端通常先检查请求方法与 Header,再按接口约定对 Body 做限长、读取和解码。GET 在协议层面并非绝对禁止携带 Body,但客户端、中间件和缓存对它的支持并不一致,查询条件通常放在 query 中更可靠。
下面的程序只在内存中构造请求,不访问外部网络,并分别读取 URL、Header 与 Body:
package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := `{"sku":"A-100","count":2}`
method := http.MethodPost
req, err := http.NewRequest(
method,
"https://api.example.com/v1/orders?dry_run=true&tag=go&tag=http",
strings.NewReader(body),
)
if err != nil {
panic(err)
}
// 请求体类型与期望响应类型分别声明,避免混淆两个 Header 的方向。
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Accept", "application/json")
data, err := io.ReadAll(req.Body)
if err != nil {
panic(err)
}
fmt.Println("scheme:", req.URL.Scheme)
fmt.Println("host:", req.URL.Host)
fmt.Println("path:", req.URL.Path)
fmt.Println("dry_run:", req.URL.Query().Get("dry_run"))
fmt.Println("tags:", req.URL.Query()["tag"])
fmt.Println("content-type:", req.Header.Get("Content-Type"))
fmt.Println("accept:", req.Header.Get("Accept"))
fmt.Println("body:", string(data))
}预期输出
scheme: https
host: api.example.com
path: /v1/orders
dry_run: true
tags: [go http]
content-type: application/json
accept: application/json
body: {"sku":"A-100","count":2}按职责顺序检查请求
服务端解析请求时,可以按“路由位置 → 查询参数 → Header → Body”建立检查顺序:先确认 path 是否命中接口,再验证 query 的格式和取值;随后检查 Content-Type 是否受支持,最后对 Body 做限长与解码。若接口支持内容协商,再根据 Accept 选择响应格式。
常见错误都来自职责混用:把敏感或大块数据塞进 query、声明 JSON 却发送其他文本、手工拼接未编码的 query,或把 Accept 当成请求体类型。把 URL、Header 与 Body 分成“地址、元数据、消息内容”三层后,请求解析和错误定位都会清晰很多。