最简Go HTTP服务仅需三行代码:导入net/http、注册根路由处理器、调用ListenAndServe监听端口;注意其阻塞特性及端口占用panic问题。

用 net/http 起一个能跑通的最小服务
Go 原生 net/http 包足够轻量,不需要任何第三方依赖就能响应 HTTP 请求。最简服务只需三行代码:
package main
import "net/http"
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("Hello, World!"))
})
http.ListenAndServe(":8080", nil)
}
运行后访问 http://localhost:8080 即可看到响应。注意两点:一是 http.ListenAndServe 默认阻塞,后续代码不会执行;二是端口被占用时会直接 panic,错误信息是 listen tcp :8080: bind: address already in use,需手动 kill 进程或换端口。
处理 GET/POST 参数不能只靠 r.URL.Query()
r.URL.Query() 只能取 URL 查询参数(如 ?name=alice),表单提交或 JSON 请求体里的数据必须显式解析。常见误区是以为 ParseForm() 能自动处理所有类型——它只对 application/x-www-form-urlencoded 和 multipart/form-data 有效。
- GET 参数:用
r.URL.Query().Get("key") - POST 表单:先调
r.ParseForm(),再用r.FormValue("key") - JSON 请求体:用
json.NewDecoder(r.Body).Decode(&v),且记得检查r.Body是否为nil
漏掉 ParseForm() 直接读 r.FormValue 会返回空字符串;没关闭 r.Body 在高并发下可能耗尽文件描述符。
立即学习“go语言免费学习笔记(深入)”;
路由不够用时,别急着上 gin 或 echo
原生 http.ServeMux 支持前缀匹配和子路由注册,适合中小项目快速分组:
mainMux := http.NewServeMux()
apiMux := http.NewServeMux()
apiMux.HandleFunc("/users", usersHandler)
apiMux.HandleFunc("/posts", postsHandler)
mainMux.Handle("/api/", http.StripPrefix("/api", apiMux))
mainMux.HandleFunc("/", homeHandler)
http.ListenAndServe(":8080", mainMux)
这样 /api/users 就能命中 apiMux 的 /users。注意 http.StripPrefix 必须带尾部斜杠,否则路径裁剪会出错;另外 ServeMux 不支持通配符(如 /user/:id),需要自己解析 r.URL.Path 或引入第三方。
静态文件服务别硬编码 http.FileServer 路径
直接写 http.FileServer(http.Dir("./static")) 在跨平台或打包部署时容易路径失效。更稳妥的方式是用 os.Executable() 定位二进制所在目录:
exePath, _ := os.Executable()
staticDir := filepath.Join(filepath.Dir(exePath), "static")
http.Handle("/static/", http.StripPrefix("/static", http.FileServer(http.Dir(staticDir))))
开发时可设环境变量切换目录,比如 STATIC_ROOT=./dev-static,避免每次改代码。还要留意:如果静态目录不存在,http.FileServer 会返回 404 而非 panic,但前端请求 /static/app.js 时若实际路径是 ./static/js/app.js,就只能靠中间件重写路径或调整前端构建配置。
真正麻烦的不是启动服务,而是请求进来后怎么区分内容类型、怎么传参、怎么不把错误吞掉——这些细节在本地跑通一次不难,但上线后日志缺失、超时没设、panic 没 recover,问题就藏得深了。










