Go / 系统课时
认识 Go net/http 核心组件
认识 Go net/http 核心组件
net/http 把一次 HTTP 交互拆成职责明确的对象:客户端发请求,传输层管理连接,服务器接收,路由器选择处理器,处理器再读请求并写响应。掌握这些关系,后续组织 Web 服务代码会简单很多。
学习目标
- 说清
Server、ServeMux、Handler与HandlerFunc的调用关系 - 理解
Request与ResponseWriter在一次服务端请求中的职责 - 理解
Client与Transport为什么应该复用
服务端围绕 Handler 接口组织
http.Handler 是服务端最核心的抽象,它只有一个方法:ServeHTTP(http.ResponseWriter, *http.Request)。只要一个值实现了这个方法,就可以交给 http.Server 处理请求。
http.HandlerFunc 是函数适配器。普通函数只要签名为 func(http.ResponseWriter, *http.Request),就能转换成 HandlerFunc,避免为每个接口单独声明结构体。http.ServeMux 自身也实现了 Handler,它根据请求的主机和路径模式选择下一级处理器,因此通常被放到 Server.Handler 字段中。

Request 与 ResponseWriter 只描述当前交互
*http.Request 包含方法、URL、Header、Body、上下文等本次请求信息。处理器应从 r.Context() 获取请求级取消信号和截止时间,而不是自己创建与请求生命周期无关的后台上下文。
http.ResponseWriter 是处理器写响应的出口。调用 Header() 可以设置响应头,WriteHeader 写状态码,Write 写响应体。第一次写响应体时如果还没有显式写状态码,默认会发送 200 OK。因此状态码和响应 Header 必须在首次写 Body 之前确定。
Client 与 Transport 位于请求发起侧
http.Client 提供 Do、Get 等高层请求 API;真正负责连接复用、代理、TLS 和底层 RoundTrip 的通常是 http.Transport。一个 Client 可以长期复用,一个 Transport 也应长期复用,这样才能使用连接池;为每次请求新建 Transport 会失去连接复用并增加资源开销。
下面的程序在本机随机端口启动 http.Server,用 ServeMux 路由到 HandlerFunc,再由一个复用的 Client 和 Transport 发起请求。随机端口不会出现在预期输出中。
package main
import (
"context"
"fmt"
"io"
"net"
"net/http"
"time"
)
func main() {
mux := http.NewServeMux()
mux.Handle("/hello", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
name := r.URL.Query().Get("name")
if name == "" {
name = "world"
}
// Handler 通过 ResponseWriter 设置响应元数据并写回消息体。
w.Header().Set("Content-Type", "text/plain; charset=utf-8")
fmt.Fprintf(w, "hello, %s\n", name)
}))
server := &http.Server{
Handler: mux,
ReadHeaderTimeout: 2 * time.Second,
}
listener, err := net.Listen("tcp", "127.0.0.1:0")
if err != nil {
panic(err)
}
go func() {
if err := server.Serve(listener); err != nil && err != http.ErrServerClosed {
panic(err)
}
}()
// Client 与 Transport 都放在请求外部创建并复用。
transport := http.DefaultTransport.(*http.Transport).Clone()
defer transport.CloseIdleConnections()
client := &http.Client{
Transport: transport,
Timeout: 2 * time.Second,
}
resp, err := client.Get("http://" + listener.Addr().String() + "/hello?name=Go")
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Print(string(data))
ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()
if err := server.Shutdown(ctx); err != nil {
panic(err)
}
}预期输出
hello, Go一次请求如何穿过这些组件
客户端调用 Client.Do 或 Get 后,Client 把请求交给配置的 Transport。Transport 建立或复用连接,把 HTTP 请求发送到服务器。Server 接收并解析请求后调用自己的 Handler;若这个 Handler 是 ServeMux,Mux 再选择具体业务 Handler。业务 Handler 读取 Request,通过 ResponseWriter 写回状态码、Header 与 Body。
服务端代码组织时,可以把 Server 看成运行边界,把 ServeMux 看成路由边界,把 Handler 看成业务入口;客户端侧则把 Client 看成调用策略,把 Transport 看成连接策略。理解这两条链路后,超时、连接池、中间件和路由拆分都会有明确的落点。