http.ListenAndServe 是阻塞调用，会一直监听端口直到出错或关闭；需提前完成初始化，必要时用 goroutine 包裹并妥善处理错误与生命周期；推荐使用 http.Server 结构体以便优雅关闭。
为什么 http.ListenAndServe 启动后程序就卡住不继续执行？
因为 http.ListenAndServe 是阻塞调用，它会一直监听端口、处理请求，直到发生错误或被显式关闭。这不是 bug，而是设计使然——Go 的 HTTP 服务器默认不启用后台 goroutine。
常见误操作是写成这样：
http.ListenAndServe(":8080", nil)
fmt.Println("这行永远不会执行") // ❌
如果后续还有初始化逻辑（比如加载配置、连接数据库），必须提前完成；若真需要“启动后继续”，才用 goroutine 包裹，但要注意错误捕获和生命周期管理：
- 用
go http.ListenAndServe(...)后，主 goroutine 不再等待，但进程可能立即退出（除非有其他阻塞） - 更稳妥的做法是用
http.Server结构体 +server.ListenAndServe()，便于后续调用server.Shutdown() - 监听失败时，
ListenAndServe返回非 nil 错误，务必检查，否则 silent fail
如何正确注册路由：别再只用 http.HandleFunc 硬编码
http.HandleFunc 只支持字符串前缀匹配，没有路径参数、没有中间件、无法嵌套路由，适合 demo，不适合真实项目。
立即学习“go语言免费学习笔记（深入）”；
实际开发中应尽早切换到标准库的 http.ServeMux 或第三方路由器（如 gorilla/mux、chi）。例如用 http.ServeMux 实现基础分组：
mux := http.NewServeMux()
mux.HandleFunc("/api/users", usersHandler)
mux.HandleFunc("/api/posts", postsHandler)
http.ListenAndServe(":8080", mux)
-
http.ServeMux支持通配符（如/static/匹配所有子路径），但不支持/user/{id}这类动态路径 - 如果需要路径参数、正则匹配、中间件链，直接上
chi.Router：它完全兼容http.Handler接口，迁移成本低 - 避免在 handler 函数里写大段业务逻辑——提取为独立函数，方便测试和复用
http.Request 中读取请求体（body）的三个关键限制
req.Body 是单次可读的 io.ReadCloser，读完即空，反复读会返回空内容或 io.EOF。这是最常踩的坑。
- 调用
req.ParseForm()、req.FormValue()或io.ReadAll(req.Body)后，req.Body就不可再用 - 如果用了中间件（比如日志、鉴权），又想在 handler 里解析 JSON，得先用
io.ReadAll把 body 读出来，再用bytes.NewReader重建req.Body - 注意
Content-Length和Transfer-Encoding: chunked场景下，req.Body行为一致，但超大 body 必须流式处理，不能全读进内存
简单复用 body 的模式：
body, _ := io.ReadAll(req.Body) req.Body = io.NopCloser(bytes.NewReader(body)) // 后续可多次解析 json.Unmarshal(body, &data)
生产环境必须设置的 http.Server 字段
直接调用 http.ListenAndServe 用的是默认配置，没有超时控制、无连接数限制、无法优雅关闭，线上等于裸奔。
-
ReadTimeout和WriteTimeout防止慢连接耗尽资源（注意：Go 1.8+ 推荐用ReadHeaderTimeout+IdleTimeout更精准） -
MaxHeaderBytes防止恶意超大 header 导致 OOM，默认是 1 -
Handler字段必须显式传入，不要依赖全局http.DefaultServeMux，否则测试难 mock，中间件难插拔 - 启动后获取 listener 并手动
server.Serve(lis)可实现端口重用、TLS 配置分离等高级场景
最小可用生产配置示例：
server := &http.Server{
Addr: ":8080",
Handler: mux,
ReadTimeout: 5 * time.Second,
WriteTimeout: 10 * time.Second,
IdleTimeout: 30 * time.Second,
}
HTTP/2、TLS、pprof 调试端点这些属于延伸需求，先确保基础 server 字段不为空、不沿用默认值，比加功能更重要。
