Go / 系统课时
建立 HTTP 请求响应模型
建立 HTTP 请求响应模型
HTTP 服务的最小心智模型不是“调用一个接口”,而是客户端发送一份请求,服务端返回一份响应。本篇用一次可运行的 Go 交换把方法、目标地址、请求头、正文、状态码和响应体对应起来,并明确两端各自负责什么。
学习目标
- 识别 HTTP 请求与响应的核心组成部分
- 区分客户端构造请求与服务端处理请求的职责
- 用 Go 程序观察一次完整请求响应交换
一次交换由什么组成
一份 HTTP 请求至少有方法和请求目标,还可以携带请求头与正文。方法表达客户端希望执行的操作,例如 GET 或 POST;请求目标通常包含路径和查询参数,例如 /orders?source=demo。请求头传递元数据,正文承载需要提交的表示。
服务端处理请求后返回响应。响应以状态码表达处理结果,再通过响应头补充元数据,通过响应体返回资源表示或错误详情。例如创建资源时常返回 201 Created,并可在 Location 响应头中给出新资源地址。
客户端最初使用完整 URL 决定协议、主机、端口和目标资源;进入服务端后,应用通常重点处理方法、路径、查询参数、头和正文。Go 的 net/http 已经把底层报文解析成 http.Request 与 http.Response,业务代码无需手工切分 HTTP 文本。

用 Go 观察完整交换
下面的程序使用 httptest.NewServer 在进程内启动临时 HTTP 服务,因此不依赖固定端口。服务端打印收到的请求要素,客户端再打印状态码、响应头和响应体。
package main
import (
"bytes"
"fmt"
"io"
"net/http"
"net/http/httptest"
)
func main() {
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
body, err := io.ReadAll(r.Body)
if err != nil {
http.Error(w, "read body failed", http.StatusBadRequest)
return
}
// RequestURI 保留路径和查询串,便于观察请求目标。
fmt.Printf(
"server <- method=%s target=%s content-type=%s body=%s\n",
r.Method,
r.URL.RequestURI(),
r.Header.Get("Content-Type"),
body,
)
w.Header().Set("Content-Type", "application/json")
w.Header().Set("Location", "/orders/42")
w.WriteHeader(http.StatusCreated)
_, _ = w.Write([]byte(`{"id":42,"status":"created"}`))
}))
defer server.Close()
req, err := http.NewRequest(
http.MethodPost,
server.URL+"/orders?source=demo",
bytes.NewBufferString(`{"sku":"A-1","qty":2}`),
)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
responseBody, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
// 客户端通过 Response 读取状态、响应头与响应体。
fmt.Printf(
"client <- status=%d location=%s body=%s\n",
resp.StatusCode,
resp.Header.Get("Location"),
responseBody,
)
}将代码保存为 main.go 后运行:
go run main.go预期输出:
server <- method=POST target=/orders?source=demo content-type=application/json body={"sku":"A-1","qty":2}
client <- status=201 location=/orders/42 body={"id":42,"status":"created"}程序把一次交换的两面放在一起:客户端负责选择方法和 URL、设置请求头与正文、发送请求并解释响应;服务端负责读取请求、校验输入、执行业务逻辑,并选择合适的状态码、响应头和响应体。
不要把协议字段混成一件事
Content-Type 描述当前正文的媒体类型,不等于请求方法;状态码属于响应,不属于请求。路径和查询参数共同参与资源定位或筛选,但敏感数据通常不应仅因为方便就放进 URL,因为 URL 可能进入日志、历史记录或监控系统。
并非每个请求或响应都有正文。HEAD 的响应不包含消息内容,204 No Content 也不能携带响应内容。对于 GET,HTTP 并未为请求内容定义通用语义,很多中间件和服务也不会支持,因此不要依赖 GET 请求体传递业务参数。
建立这个模型后,阅读 Go Web 代码时可以始终沿着“客户端构造 Request → 服务端处理 Request → 服务端构造 Response → 客户端解释 Response”追踪一次交换,方法、目标、头、正文和状态码就不会混在一起。