Go net/http 包轻量稳定，几行代码即可启动生产级HTTP服务器；需检查ListenAndServe返回值、合理处理路由、表单解析和超时控制。
Go 内置的 net/http 包足够轻量、稳定，几行代码就能跑起一个生产可用的 HTTP 服务器——不需要框架，也不用额外依赖。
用 http.ListenAndServe 启动最简服务
这是 Go Web 服务的入口函数，它阻塞运行，监听指定地址并分发请求。常见错误是忽略返回值，导致 panic 不被感知或日志丢失。
-
http.ListenAndServe第二个参数为nil时，使用默认的http.DefaultServeMux -
端口被占用时会返回
listen tcp :8080: bind: address already in use错误，需主动捕获 - 监听
:80需要 root 权限；开发建议用:8080或更高端口
package main
import (
"fmt"
"log"
"net/http"
)
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Hello, World!")
})
log.Println("Server starting on :8080")
if err := http.ListenAndServe(":8080", nil); err != nil {
log.Fatal(err) // 别漏掉这个检查
}
}
路由不够用？手动注册 http.ServeMux
默认多路复用器（DefaultServeMux）只支持前缀匹配，不支持路径参数或正则。需要更精细控制时，应显式创建 http.ServeMux 实例。
- 多个
HandleFunc注册相同路径会 panic：panic: http: multiple registrations for / -
ServeMux不处理 trailing slash 自动重定向（比如/api和/api/被视为不同路径） - 若需 REST 风格路由（如
/user/123），得自己解析r.URL.Path，或改用第三方路由器（如gorilla/mux、chi）
package main
import (
"fmt"
"log"
"net/http"
)
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
fmt.Fprint(w, "ok")
})
mux.HandleFunc("/api/", func(w http.ResponseWriter, r *http.Request) {
// 注意：/api/ 开头的路径才会进来，/api 不会匹配
fmt.Fprintf(w, "API path: %s", r.URL.Path)
})
log.Println("Server starting on :8080")
if err := http.ListenAndServe(":8080", mux); err != nil {
log.Fatal(err)
}
}
处理 POST 请求和表单数据
Go 对 application/x-www-form-urlencoded 和 multipart/form-data 提供原生支持，但必须调用 r.ParseForm() 或 r.ParseMultipartForm() 才能读取 r.FormValue。
- 忘记调用
ParseForm()会导致r.FormValue始终返回空字符串 - 对 JSON 请求体，不能用
FormValue，得用json.Decoder读取r.Body -
r.Body只能读一次；后续再读会得到空内容，需用io.ReadAll缓存或设计中间件复制
package main
import (
"fmt"
"log"
"net/http"
)
func main() {
http.HandleFunc("/login", func(w http.ResponseWriter, r *http.Request) {
if r.Method == "POST" {
if err := r.ParseForm(); err != nil {
http.Error(w, "Bad request", http.StatusBadRequest)
return
}
user := r.FormValue("username")
pass := r.FormValue("password")
fmt.Fprintf(w, "Login attempt: %s / %s", user, pass)
return
}
// GET 返回登录表单
fmt.Fprint(w, ``)
})
log.Println("Server starting on :8080")
if err := http.ListenAndServe(":8080", nil); err != nil {
log.Fatal(err)
}
}
HTTP 处理函数里最容易被忽略的是超时控制和连接生命周期管理——ListenAndServe 本身不提供读写超时，需用 http.Server 结构体手动配置 ReadTimeout、WriteTimeout 或 ReadHeaderTimeout，否则慢客户端可能长期占用连接。
