最简http服务需先注册路由再启动:用http.handlefunc定义处理器,再调用http.listenandserve;未注册路由将全返回404,端口冲突会panic,建议从环境变量读端口。

用 net/http 启一个最简 HTTP 服务就够了
Go 写服务器,net/http 包开箱即用,不需要额外框架就能跑通生产级基础服务。核心就两步:定义处理函数、调用 http.ListenAndServe。
常见错误是直接写 http.ListenAndServe(":8080", nil) 就以为完事——但没注册任何路由,所有请求都会返回 404。
- 必须先用
http.HandleFunc或http.Handle注册路径和处理器 - 端口被占用时,
ListenAndServe会直接 panic,建议捕获 error 并 log - 开发时用
":8080"没问题,上线别硬写端口,从环境变量读更稳妥(比如os.Getenv("PORT"))
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("hello"))
})
log.Fatal(http.ListenAndServe(":8080", nil))
}
路由不够用?别急着上 gin 或 echo
原生 http.ServeMux 支持前缀匹配和子路由挂载,小中型服务完全够用。第三方框架的启动开销、中间件隐式行为、调试栈变深,反而在简单场景拖慢迭代节奏。
容易踩的坑是误以为 http.ServeMux 不支持路径参数——它确实不支持 /user/:id 这种语法,但你可以用 strings.Split(r.URL.Path, "/") 手动解析,或加一层轻量封装。
- 多个
http.ServeMux实例可共存,适合按模块拆分路由逻辑 - 用
http.StripPrefix配合子 mux 处理静态资源路径(如/static/) - 如果真需要正则路由,优先考虑
gorilla/mux而非 gin,它更贴近标准库风格,无反射魔法
HTTP handler 里怎么安全读取请求数据
别直接用 r.Body 读两次——Go 的 io.ReadCloser 是单次消费的,第二次读会返回空或 EOF。常见错误是先 json.Decode,再想拿原始 body 做日志或签名验证。
正确做法是提前用 io.ReadAll 把 body 全部读进内存,再分别解析或复用:
- 注意
Content-Length过大时可能 OOM,务必设限(比如http.MaxBytesReader) - 表单数据优先用
r.ParseForm()+r.FormValue,比手动解析body更可靠 - 上传文件必须调用
r.ParseMultipartForm,否则r.MultipartForm为 nil
body, err := io.ReadAll(http.MaxBytesReader(w, r.Body, 1 <h3>服务退出时怎么优雅关机</h3> <p>直接 kill 进程会导致正在处理的请求被中断,连接重置,客户端收到不完整响应。Go 1.8+ 提供了 <code>http.Server.Shutdown</code>,但必须配合信号监听和超时控制。</p> <p>最容易忽略的是:Shutdown 不会自动关闭 listener,也不等待 handler 函数返回——你得自己确保 handler 内部不阻塞、有上下文超时。</p>
- 用
signal.Notify监听os.Interrupt和syscall.SIGTERM - 调用
srv.Shutdown前,应先关闭所有后台 goroutine(比如定时任务、消息轮询) - Shutdown 的 context 超时时间要略长于最长 handler 耗时,否则强制终止仍会发生
没有做这些,哪怕用了 Shutdown,照样丢请求。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











