Golang使用net/http处理Web请求示例_技术教程

最简路由用 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 请求会返回空字符串。

容易踩的坑：

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})
}