Golang使用net/http处理HTTP请求

P粉602998670

发布时间：2026-01-09 16:46:55

999人浏览过

来源于php中文网

原创

最常见原因是没启动服务器或 ListenAndServe 后程序退出；注册路由仅存入 DefaultServeMux，需调用 ListenAndServe 才生效，且须确保其为 main goroutine 最后调用。

golang使用net/http处理http请求

为什么 `http.HandleFunc` 注册的路由不生效？

最常见原因是没启动服务器，或 http.ListenAndServe 调用后程序直接退出。注册路由只是往默认的 http.DefaultServeMux 里塞函数，真正监听和分发要靠 ListenAndServe 启动。

确保调用 http.ListenAndServe(":8080", nil)，第二个参数为 nil 表示使用默认多路复用器
如果用了自定义 http.ServeMux，必须显式传入 ListenAndServe 第二个参数，不能传 nil
检查端口是否被占用，错误日志会输出 listen tcp :8080: bind: address already in use
Go 程序在 ListenAndServe 后不会自动阻塞——如果它不是 main goroutine 的最后调用，后续代码执行完进程就退出了

如何读取 URL 查询参数和表单数据？

req.URL.Query() 拿查询参数（?name=alice&age=30），req.ParseForm() 才能读 POST 的 application/x-www-form-urlencoded 或 multipart/form-data 数据。两者互不影响，但顺序有讲究。

对 GET 请求，直接用 req.URL.Query().Get("key")
对 POST 表单，先调 req.ParseForm()（否则 req.Form 是空的），再用 req.FormValue("key")
ParseForm() 会自动识别 Content-Type 并解析；若请求体是 JSON，则不应调用它，而该用 json.Decoder
重复键（如 ?tag=a&tag=b）用 req.URL.Query()["tag"] 获取切片，Get 只返回第一个

怎么正确处理 JSON 请求和响应？

别手动拼接字符串或用 fmt.Fprintf 输出 JSON——容易出格式错误、缺少 Content-Type、不处理编码问题。

Text-To-Pokemon口袋妖怪

输入文本生成自己的Pokemon，还有各种选项来定制自己的口袋妖怪

下载

写响应：设头 w.Header().Set("Content-Type", "application/json; charset=utf-8")，再用 json.NewEncoder(w).Encode(v)
读请求：用 json.NewDecoder(req.Body).Decode(&v)，别用 io.ReadAll + json.Unmarshal，除非你明确需要原始字节
注意 req.Body 只能读一次；如果之前调过 ParseForm() 或 ParseMultipartForm()，Body 可能已被消费，需提前保存或重置
错误时也应返回 JSON 响应（如 {"error": "invalid json"}），并设 http.StatusBadRequest

func handleUser(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json; charset=utf-8")
    if r.Method != "POST" {
        http.Error(w, `{"error":"method not allowed"}`, http.StatusMethodNotAllowed)
        return
    }
    var u struct{ Name string `json:"name"` }
    if err := json.NewDecoder(r.Body).Decode(&u); err != nil {
        http.Error(w, `{"error":"invalid json"}`, http.StatusBadRequest)
        return
    }
    json.NewEncoder(w).Encode(map[string]string{"msg": "ok", "name": u.Name})
}