标题：Golang net/http库实战指南：从零构建HTTP服务与客户端
关键词：Go语言, net/http, HTTP服务器, HTTP客户端, RESTful API
描述：深入解析Golang标准库net/http的核心用法，通过实战代码演示如何快速构建高并发HTTP服务与高效客户端，涵盖路由、中间件、超时控制等关键场景。

正文：
在云原生时代，Golang凭借其卓越的并发模型和简洁的语法，已成为构建高性能HTTP服务的利器。其标准库net/http更是一个"开箱即用"的瑞士军刀，本文将带你深入实战，掌握从基础到进阶的核心用法。

一、HTTP服务器：五分钟快速上线

只需5行代码就能启动一个Web服务：
go
package main
import "net/http"

func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("Hello, 世界!"))
})
http.ListenAndServe(":8080", nil)
}
关键点解析：
1. HandleFunc方法将路径与处理函数绑定
2. ResponseWriter实现io.Writer接口，支持流式写入
3. ListenAndServe第二个参数nil表示使用默认路由器

二、路由进阶：构建RESTful API

实际项目中需要更灵活的路由控制：
go
// 创建多路复用器
mux := http.NewServeMux()

// 注册RESTful路由
mux.HandleFunc("GET /products", listProducts)
mux.HandleFunc("POST /products", createProduct)
mux.HandleFunc("GET /products/{id}", getProductDetail)

// 启动服务
http.ListenAndServe(":8080", mux)
路径参数可通过r.PathValue("id")直接获取，告别繁琐的正则匹配。

三、中间件：洋葱式处理链

实现认证日志等通用功能：
go
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
next.ServeHTTP(w, r)
fmt.Printf("%s %s processed in %v\n", r.Method, r.URL.Path, time.Since(start))
})
}

// 使用方式
mux := http.NewServeMux()
mux.HandleFunc("/", homeHandler)
wrappedMux := loggingMiddleware(mux)
中间件模式允许无限嵌套，实现关注点分离。

四、生产级服务器配置

真实环境需要精细化控制：
go
server := &http.Server{
Addr: ":8443",
Handler: wrappedMux,
ReadTimeout: 5 * time.Second, // 防慢客户端攻击
WriteTimeout: 10 * time.Second, // 防响应阻塞
IdleTimeout: 60 * time.Second, // 连接复用超时
}

// 优雅关闭
go func() {
if err := server.ListenAndServeTLS("cert.pem", "key.pem"); err != nil {
log.Fatal(err)
}
}()

// 捕获退出信号
quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGTERM)
<-quit
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
server.Shutdown(ctx)

五、HTTP客户端：不只是Get请求

复杂场景下的客户端实践：
go
// 创建可复用的客户端
client := &http.Client{
Timeout: 15 * time.Second,
Transport: &http.Transport{
MaxIdleConns: 100,
IdleConnTimeout: 90 * time.Second,
TLSHandshakeTimeout: 10 * time.Second,
},
}

// 带JSON体的POST请求
payload, _ := json.Marshal(map[string]string{"key": "value"})
req, _ := http.NewRequest("POST", "https://api.example.com", bytes.NewBuffer(payload))
req.Header.Set("Content-Type", "application/json")

// 上下文超时控制
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
req = req.WithContext(ctx)

resp, err := client.Do(req)
if err != nil {
// 处理超时/网络错误
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println("响应状态:", resp.StatusCode, "内容:", string(body))

六、高阶技巧：文件服务器与流处理

静态文件服务一行代码搞定：
go
// 文件服务
fs := http.FileServer(http.Dir("./static"))
http.Handle("/static/", http.StripPrefix("/static", fs))

// 流式响应
http.HandleFunc("/stream", func(w http.ResponseWriter, r *http.Request) {
flusher, _ := w.(http.Flusher)
for i := 0; i < 10; i++ {
fmt.Fprintf(w, "Chunk %d\n", i)
flusher.Flush()
time.Sleep(500 * time.Millisecond)
}
})

性能陷阱警示：
1. 忘记defer resp.Body.Close()会导致内存泄漏
2. 直接读取大文件到内存可能引发OOM，推荐使用io.Copy
3. 默认客户端无超时限制，生产环境必须显式设置