最简路由用 http.HandleFunc("/path", handler) 注册，handler 必须是 func(http.ResponseWriter, *http.Request)，传 nil 到 ListenAndServe 会使用全局不安全的 DefaultServeMux，生产环境应显式创建 ServeMux 或自定义 Handler。
怎么用 http.HandleFunc 注册一个最简路由
直接调用 http.HandleFunc 就能绑定路径和处理函数，它内部会把 handler 注册到默认的 http.DefaultServeMux。注意函数签名必须是 func(http.ResponseWriter, *http.Request)，少一个参数或类型不对都会编译失败。
常见错误：传入闭包但忘了接收 *http.Request，或者误写成 func(w http.ResponseWriter, r *http.Request) error —— http.HandlerFunc 不接受返回值。
func main() {
http.HandleFunc("/hello", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
w.Write([]byte("Hello, World!"))
})
http.ListenAndServe(":8080", nil)
}
为什么 http.ListenAndServe 第二个参数传 nil 有时会出问题
传 nil 表示使用默认多路复用器（http.DefaultServeMux），但这个对象是全局、并发不安全的——多个包同时调用 http.HandleFunc 可能导致 panic 或路由覆盖。生产环境建议显式构造自己的 http.ServeMux 或直接用自定义 http.Handler。
- 多个测试文件里都写
http.HandleFunc？很可能互相干扰 - 想加中间件（如日志、CORS）？
nil模式没法套壳 -
http.ListenAndServe默认启用 HTTP/1.1，不支持 HTTP/2（需 TLS + 自定义http.Server）
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/api/user", userHandler)
srv := &http.Server{
Addr: ":8080",
Handler: mux,
}
srv.ListenAndServe()
}
如何在 handler 中安全读取 query 和 form 数据
r.URL.Query() 用于解析 URL 查询参数，r.ParseForm() 才能读取 POST 表单（包括 application/x-www-form-urlencoded）。二者互不影响，但顺序有讲究：如果先调用 r.FormValue 而没提前 ParseForm，对 POST 请求会返回空字符串。
立即学习“go语言免费学习笔记（深入）”；
容易踩的坑：
-
r.FormValue("key")自动合并 query 和 form，但前提是已调用过ParseForm或ParseMultipartForm - 上传文件时必须用
ParseMultipartForm，否则r.MultipartForm为nil - 重复调用
ParseForm不会报错，但可能触发多次 body 读取（body 只能读一次）
func dataHandler(w http.ResponseWriter, r *http.Request) {
if err := r.ParseForm(); err != nil {
http.Error(w, "bad request", http.StatusBadRequest)
return
}
name := r.FormValue("name") // 同时从 query 和 form 取
email := r.PostFormValue("email") // 仅从 POST body 取
fmt.Fprintf(w, "Name: %s, Email: %s", name, email)
}
怎样让 handler 支持 JSON 输入输出并避免 panic
手动处理 JSON 最常出错的是忽略错误、不设 Content-Type、或对空 body 调用 json.NewDecoder(r.Body).Decode() 导致 panic。务必检查 r.Body 是否为 nil，且 decode 前要确认请求体可读（比如用 r.Method == "POST" 过滤）。
关键点：
- 写 JSON 前记得设
w.Header().Set("Content-Type", "application/json") - 用
json.NewEncoder(w).Encode(v)替代json.Marshal+w.Write，避免内存拷贝和手动错误处理 - 读 JSON 前建议限制 body 大小（
r.Body = http.MaxBytesReader(w, r.Body, 1）防攻击
func jsonHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
return
}
w.Header().Set("Content-Type", "application/json")
var req struct{ Name string }
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
http.Error(w, "invalid JSON", http.StatusBadRequest)
return
}
json.NewEncoder(w).Encode(map[string]string{"message": "ok", "name": req.Name})
}
实际项目中，路由嵌套、中间件组合、错误统一处理这些环节比单个 handler 复杂得多，但所有复杂性都始于对 http.Handler 接口本质的理解：它只是一个函数，输入是请求，输出是响应，其余全是围绕它的封装与约束。 
