2、标准库 net/http：http.Handler 接口、HandlerFunc 适配器、ServeMux 路由、默认 Server

Go 标准库 net/http 是构建 HTTP 服务的基石，也是中间件接入链路的起点。理解其核心接口与组件，是掌握后续中间件模式的前提。本节将深入剖析 http.Handler 接口、HandlerFunc 适配器、ServeMux 路由以及默认 Server 的实现原理与协作方式。

2.1 http.Handler 接口：中间件的契约

所有 HTTP 处理逻辑在 Go 中都必须实现 http.Handler 接口。该接口仅包含一个方法：

type Handler interface {
    ServeHTTP(ResponseWriter, *Request)
}

• ResponseWriter：用于构造 HTTP 响应，写入状态码、Header 和 Body。
• *Request：代表客户端发来的 HTTP 请求，包含 URL、Header、Body 等信息。

任何实现了 ServeHTTP 方法的类型都可以作为 HTTP 处理器。这种设计使得中间件可以包装另一个 Handler，在调用其 ServeHTTP 前后插入逻辑，形成链式调用。

2.2 HandlerFunc 适配器：函数到接口的桥梁

为了简化将普通函数转换为 Handler 的过程，标准库提供了 http.HandlerFunc 适配器：

type HandlerFunc func(ResponseWriter, *Request)

func (f HandlerFunc) ServeHTTP(w ResponseWriter, r *Request) {
    f(w, r)
}

HandlerFunc 是一个拥有 ServeHTTP 方法的函数类型。它允许开发者直接使用函数签名 func(w http.ResponseWriter, r *http.Request) 来定义处理器，而无需定义新的结构体。这种适配器模式是 Go 接口设计哲学的典型体现。

2.3 ServeMux 路由：请求分发器

http.ServeMux 是标准库提供的 HTTP 请求多路复用器（路由）。它实现了 http.Handler 接口，内部维护一个路由表，根据请求的 URL 路径将请求分发到注册的处理器。

mux := http.NewServeMux()
mux.HandleFunc("/api/", apiHandler)   // 前缀匹配
mux.HandleFunc("/health", healthHandler) // 精确匹配

路由匹配规则：

• 精确匹配：路径完全一致时命中。
• 前缀匹配：以“/”结尾的路径会匹配所有以该路径开头的请求。
• 最长匹配优先：当多个模式匹配时，选择最长的那个。

2.4 默认 Server：HTTP 服务实例

http.Server 结构体定义了运行 HTTP 服务所需的全部配置。当不显式创建 Server 实例时，http.ListenAndServe 会使用默认的 Server 配置。

// 默认方式（使用全局默认 Server）
http.ListenAndServe(":8080", mux)

// 显式创建 Server 实例
server := &http.Server{
    Addr:         ":8080",
    Handler:      mux,
    ReadTimeout:  10 * time.Second,
    WriteTimeout: 10 * time.Second,
    IdleTimeout:  30 * time.Second,
}
server.ListenAndServe()

默认 Server 的局限性：

• 没有设置超时，可能导致连接被长时间占用。
• 使用默认的 http.DefaultServeMux，容易被第三方库注册路由污染。
• 缺少优雅关机和错误处理机制。

2.5 核心组件关系总结