2. Go Web服务基础：使用标准库net/http搭建一个简单的HTTP服务

在深入蓝绿发布与健康检查之前，必须掌握Go语言标准库中最核心的Web构建模块——net/http。Go语言的设计哲学强调“开箱即用”，net/http包提供了完整的HTTP客户端与服务器端实现，无需依赖任何第三方框架即可搭建生产级别的HTTP服务。本章将系统性地拆解其核心组件，并构建一个可运行的基础服务。

2.1 net/http核心组件架构

net/http包围绕三个核心抽象构建：处理器（Handler）、多路复用器（ServeMux）和服务器（Server）。理解这三者的关系是搭建任何Go Web服务的前提。

2.2 构建第一个HTTP服务：三步法

使用标准库搭建HTTP服务仅需三个步骤：定义处理器、注册路由、启动监听。以下代码演示了最精简的实现方式。

package main

import (
    "fmt"
    "net/http"
)

// 1. 定义处理器：实现 http.Handler 接口
type helloHandler struct{}

func (h *helloHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Hello, Go Web Service!")
}

func main() {
    // 2. 注册路由：将路径 /hello 绑定到处理器
    http.Handle("/hello", &helloHandler{})

    // 3. 启动服务器：监听 8080 端口
    fmt.Println("Server starting on :8080...")
    err := http.ListenAndServe(":8080", nil)
    if err != nil {
        fmt.Printf("Server failed: %v\n", err)
    }
}

2.3 使用处理器函数简化开发

为每个处理器定义一个结构体略显繁琐。Go提供了http.HandlerFunc类型，允许将普通函数直接用作处理器，极大简化代码。

package main

import (
    "fmt"
    "net/http"
)

// 使用 HandlerFunc：将普通函数转换为处理器
func helloHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Hello from HandlerFunc!")
}

func main() {
    // http.HandleFunc 自动将函数转换为 HandlerFunc 类型
    http.HandleFunc("/hello", helloHandler)

    // 也可以直接使用匿名函数
    http.HandleFunc("/ping", func(w http.ResponseWriter, r *http.Request) {
        w.WriteHeader(http.StatusOK)
        w.Write([]byte(`{"status":"ok"}`))
    })

    http.ListenAndServe(":8080", nil)
}

2.4 请求与响应：核心对象详解

每个HTTP请求都对应一个*http.Request对象，而响应则通过http.ResponseWriter接口写入。掌握这两个对象是构建业务逻辑的基础。

2.4.1 http.Request 关键字段

2.4.2 ResponseWriter 核心方法

// 完整的请求处理示例：解析参数并返回 JSON
func userHandler(w http.ResponseWriter, r *http.Request) {
    // 设置响应头
    w.Header().Set("Content-Type", "application/json")

    // 解析查询参数
    name := r.URL.Query().Get("name")
    if name == "" {
        name = "anonymous"
    }

    // 根据方法分支处理
    switch r.Method {
    case http.MethodGet:
        w.WriteHeader(http.StatusOK)
        fmt.Fprintf(w, `{"message":"Hello %s","method":"GET"}`, name)
    case http.MethodPost:
        // 读取请求体
        body := make([]byte, r.ContentLength)
        r.Body.Read(body)
        w.WriteHeader(http.StatusCreated)
        fmt.Fprintf(w, `{"received":"%s","method":"POST"}`, string(body))
    default:
        w.WriteHeader(http.StatusMethodNotAllowed)
        w.Write([]byte(`{"error":"method not allowed"}`))
    }
}

2.5 路由增强：Go 1.22+ 路径参数与模式匹配

Go 1.22版本对net/http的路由能力进行了重大增强，引入了路径参数和更灵活的模式匹配，减少了对外部路由库的依赖。

package main

import (
    "fmt"
    "net/http"
)

func main() {
    mux := http.NewServeMux()

    // 路径参数：使用 {name} 语法
    mux.HandleFunc("GET /users/{id}", func(w http.ResponseWriter, r *http.Request) {
        id := r.PathValue("id")
        fmt.Fprintf(w, "User ID: %s", id)
    })

    // 通配符匹配：匹配 /api/ 下的所有路径
    mux.HandleFunc("GET /api/{path...}", func(w http.ResponseWriter, r *http.Request) {
        path := r.PathValue("path")
        fmt.Fprintf(w, "API path: %s", path)
    })

    // 精确方法 + 路径
    mux.HandleFunc("POST /users", func(w http.ResponseWriter, r *http.Request) {
        w.WriteHeader(http.StatusCreated)
        w.Write([]byte(`{"status":"created"}`))
    })

    http.ListenAndServe(":8080", mux)
}

2.6 服务配置与优雅关闭

生产环境中的HTTP服务需要精细控制超时、并发和生命周期。使用http.Server结构体可以配置这些参数，并结合context实现优雅关闭。

package main

import (
    "context"
    "fmt"
    "net/http"
    "os"
    "os/signal"
    "syscall"
    "time"
)

func main() {
    // 配置 Server 结构体
    srv := &http.Server{
        Addr:         ":8080",
        Handler:      nil, // 使用 DefaultServeMux
        ReadTimeout:  10 * time.Second,
        WriteTimeout: 10 * time.Second,
        IdleTimeout:  30 * time.Second,
    }

    // 注册路由
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        w.Write([]byte("Hello, production!"))
    })

    // 在 goroutine 中启动服务器
    go func() {
        fmt.Println("Server starting on :8080...")
        if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
            fmt.Printf("ListenAndServe error: %v\n", err)
        }
    }()

    // 等待中断信号
    quit := make(chan os.Signal, 1)
    signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
    <-quit
    fmt.Println("Shutting down server...")

    // 创建带超时的 context
    ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)
    defer cancel()

    // 优雅关闭：等待活跃连接处理完毕
    if err := srv.Shutdown(ctx); err != nil {
        fmt.Printf("Server forced to shutdown: %v\n", err)
    }
    fmt.Println("Server exited gracefully")
}

2.7 本章小结

通过本章的学习，你已经掌握了使用Go标准库net/http搭建HTTP服务的完整流程：

• 理解了Handler → ServeMux → Server三层架构的设计思想。
• 掌握了两种处理器定义方式：结构体实现接口与HandlerFunc函数适配器。
• 学会了操作Request与ResponseWriter处理请求和生成响应。
• 了解了Go 1.22+的路由增强特性，包括路径参数和模式匹配。
• 实现了生产级别的服务配置与优雅关闭机制。