go 的 net/http 包虽开箱即用,但需注意端口冲突panic、路由注册时机、handler签名正确性、路径匹配缺陷、请求体解析顺序、静态文件路径穿越等关键陷阱。
Go 的 net/http 包开箱即用,不需要额外框架就能跑起一个生产可用的 Web 服务——但直接上手容易在路由、中间件、错误处理这些地方掉坑里。
用 http.HandleFunc 和 http.ListenAndServe 启动最简服务
这是零依赖启动 Web 服务的底线写法。关键不是“能不能跑”,而是“怎么避免 panic 崩溃”:
-
http.ListenAndServe默认监听:8080,端口被占会直接 panic,建议显式传入nil第二个参数(使用默认http.DefaultServeMux),并用log.Fatal包一层捕获错误 - 路由注册必须在
ListenAndServe之前,否则请求进来时找不到 handler,返回 404 且无提示 - 函数签名必须是
func(http.ResponseWriter, *http.Request),少一个星号或类型错位,编译不报错但运行时 panic
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(200)
w.Write([]byte("Hello, Go"))
})
log.Fatal(http.ListenAndServe(":8080", nil))
}
手动实现多路径路由时别硬写 if-else 链
当需要支持 /users、/posts 等多个路径,用 r.URL.Path 做字符串比对看似简单,但很快会失控:
- 路径末尾斜杠是否允许(
/users/vs/users)需手动 trim,否则 404 - 带参数的路径如
/users/123无法提取 ID,得靠正则或第三方库,自己写易出错 - HTTP 方法(GET/POST)混在一起处理,容易忽略方法校验,导致 POST 请求被 GET handler 处理
更稳的做法是:用 switch r.Method + strings.HasPrefix 做粗筛,再进具体 handler 做细粒度解析。例如: