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 文本。

HTTP 请求响应完整交换时序图

用 Go 观察完整交换

下面的程序使用 httptest.NewServer 在进程内启动临时 HTTP 服务,因此不依赖固定端口。服务端打印收到的请求要素,客户端再打印状态码、响应头和响应体。

go
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 后运行:

bash
go run main.go

预期输出:

text
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”追踪一次交换,方法、目标、头、正文和状态码就不会混在一起。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

建立 HTTP 请求响应模型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通