Go HTTP服务需注意监听地址为":8080"、路由注册须在ListenAndServe前、响应JSON必须设Content-Type、错误用http.Error、pprof需显式注册且开发期启用。
Go 语言写 HTTP 服务，不用框架也能快速跑起来，关键是别绕开 net/http 的核心逻辑，否则后续加中间件、路由分组、错误处理时会反复踩坑。
用 http.HandleFunc 和 http.ListenAndServe 启动最简服务
这是 Go Web 的“Hello World”起点，但很多人只复制代码，没注意两个关键点：监听地址默认不绑定 0.0.0.0，且 http.ListenAndServe 第二个参数为 nil 时才启用默认多路复用器（http.DefaultServeMux）。
常见错误现象：curl localhost:8080 返回 connection refused，其实是监听了 127.0.0.1:8080 而非 :8080；或者自定义了 http.ServeMux 却传给 ListenAndServe 的是 nil，导致路由不生效。
- 监听所有网卡：用
":8080"，不是"localhost:8080"或"127.0.0.1:8080" - 注册路由必须在
ListenAndServe之前，Go 不会动态重载路由表 - 如果要用自定义路由，传入非
nil的http.Handler，比如http.ListenAndServe(":8080", myMux)
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(200)
w.Write([]byte("Hello, Go HTTP"))
})
http.ListenAndServe(":8080", nil) // 注意第二个参数是 nil
}
处理 URL 路径参数和查询参数用 r.URL.Path 和 r.URL.Query()
Go 原生不支持类似 /user/:id 的路径匹配，http.ServeMux 只做前缀匹配。想取路径最后一段或解析 query，得手动操作字符串或用 url.ParseQuery。
立即学习“go语言免费学习笔记（深入）”；
使用场景：API 返回 JSON、根据 query 参数过滤列表、简单 REST 风格接口（如 /posts?id=123）。
-
r.URL.Path是原始路径字符串，带前导/，需用strings.TrimPrefix(r.URL.Path, "/")提取资源名 -
r.URL.Query().Get("page")安全取值，返回空字符串而非 panic；r.URL.Query().Get("limit")若未传，结果为空，别直接转 int - 避免用
r.FormValue混合处理 POST body 和 query —— 它会自动调用ParseForm，对非表单请求（如 JSON）可能阻塞或出错
返回 JSON 时务必设置 Content-Type: application/json
很多初学者用 json.Marshal 序列化后直接 w.Write，浏览器或 curl 看起来“能用”，但实际响应头是 text/plain，前端 fetch().json() 会因 MIME 类型不匹配静默失败。
性能影响：不设 header 不影响吞吐，但兼容性差；某些代理或 CDN 可能根据 Content-Type 做缓存策略。
- 必须写：
w.Header().Set("Content-Type", "application/json; charset=utf-8") - 推荐用
http.Error(w, msg, statusCode)处理错误响应，它会自动设Content-Type: text/plain并写状态码 - 不要在
WriteHeader前调用w.Write，否则 Go 会忽略你设的状态码，降级为 200
func apiHandler(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json; charset=utf-8")
json.NewEncoder(w).Encode(map[string]string{"status": "ok"})
}
开发阶段用 net/http/pprof 查 CPU 和内存，别等上线才想起性能问题
pprof 是 Go 自带的诊断工具，但默认不暴露，需要显式注册 handler。它不依赖第三方包，几行代码就能接入，比临时加日志或重启服务查得快得多。
容易被忽略的地方：pprof 的 /debug/pprof/ 路由默认注册在 http.DefaultServeMux，如果你用了自定义 http.ServeMux 却没手动注册，就访问不到；另外，生产环境务必限制访问 IP 或加认证，别直接暴露。
- 开发期快速启用：
import _ "net/http/pprof"，再确保http.ListenAndServe第二个参数是nil - 查看 goroutine 列表：
curl http://localhost:8080/debug/pprof/goroutine?debug=1 - 采样 30 秒 CPU：
curl -o cpu.pprof "http://localhost:8080/debug/pprof/profile?seconds=30"，然后用go tool pprof cpu.pprof分析
真正卡住人的往往不是语法，而是没意识到 http.ServeMux 的前缀匹配规则、没检查响应头、或者把开发期调试手段（如 pprof）留到线上才配——这些细节不写进代码里，光看文档根本记不住。
