2. Go Web 基础回顾：HTTP 协议基础、Go 标准库 net/http 快速搭建 Web 服务、路由与中间件概念

2.1 HTTP 协议核心要素

HTTP（HyperText Transfer Protocol）是 Web 服务的通信基石。Go 的 net/http 标准库完整实现了 HTTP/1.1 和 HTTP/2 协议，理解其核心要素是编写正确 Web 服务的前提。

2.2 使用 net/http 快速搭建 Web 服务

Go 标准库 net/http 无需第三方依赖即可启动 HTTP 服务。以下是最小可运行的服务示例：

package main

import (
    "encoding/json"
    "log"
    "net/http"
)

type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
}

func getUserHandler(w http.ResponseWriter, r *http.Request) {
    // 仅允许 GET 方法
    if r.Method != http.MethodGet {
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
        return
    }

    user := User{ID: 1, Name: "Alice"}
    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(http.StatusOK)
    json.NewEncoder(w).Encode(user)
}

func main() {
    http.HandleFunc("/api/user", getUserHandler)
    log.Println("Server starting on :8080")
    log.Fatal(http.ListenAndServe(":8080", nil))
}

2.3 路由与 ServeMux 机制

Go 标准库的路由器是 http.ServeMux，它基于路径前缀匹配，不支持参数化路由（如 /user/:id）。

2.4 中间件概念与链式处理

中间件（Middleware）是包裹在核心 Handler 前后的处理函数，用于横切关注点：日志、鉴权、限流、超时控制等。Go 中典型的中间件模式是函数式嵌套：

// 中间件类型：接收 Handler，返回 Handler
type Middleware func(http.Handler) http.Handler

// 日志中间件
func LoggingMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        log.Printf("[%s] %s %s", r.Method, r.URL.Path, r.RemoteAddr)
        next.ServeHTTP(w, r) // 调用下一个 Handler
    })
}

// 鉴权中间件
func AuthMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        token := r.Header.Get("Authorization")
        if token == "" {
            http.Error(w, "Unauthorized", http.StatusUnauthorized)
            return
        }
        // 验证 token...
        next.ServeHTTP(w, r)
    })
}

// 链式组合
func main() {
    handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        w.Write([]byte("Hello, World!"))
    })

    // 从内到外：Auth → Logging → handler
    wrapped := LoggingMiddleware(AuthMiddleware(handler))
    http.Handle("/api/secure", wrapped)
    http.ListenAndServe(":8080", nil)
}

2.5 契约压测视角：为什么需要回顾这些基础？

• 路由匹配： 压测脚本必须使用正确的路径和 HTTP 方法，否则请求无法到达目标 Handler。
• 中间件影响： 鉴权、限流、日志中间件会改变请求处理路径和响应时间，压测需考虑中间件开销。
• 响应结构： 契约验证依赖精确的响应状态码、Header 和 Body 结构，这些由 Handler 和中间件共同决定。
• 错误处理： 中间件或 Handler 中未捕获的 panic 会导致 500 响应，压测需覆盖异常路径。