Go语言搭建简易HTTP服务教程

在Golang实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《Go语言搭建简单HTTP服务教程》，聊聊，希望可以帮助到正在努力赚钱的你。

Go HTTP服务需注意监听地址为":8080"、路由注册须在ListenAndServe前、响应JSON必须设Content-Type、错误用http.Error、pprof需显式注册且开发期启用。

Go 语言写 HTTP 服务，不用框架也能快速跑起来，关键是别绕开 net/http 的核心逻辑，否则后续加中间件、路由分组、错误处理时会反复踩坑。

用 http.HandleFunc 和 http.ListenAndServe 启动最简服务

这是 Go Web 的“Hello World”起点，但很多人只复制代码，没注意两个关键点：监听地址默认不绑定 0.0.0.0，且 http.ListenAndServe 第二个参数为 nil 时才启用默认多路复用器（http.DefaultServeMux）。

常见错误现象：curl localhost:8080 返回 connection refused，其实是监听了 127.0.0.1:8080 而非 :8080；或者自定义了 http.ServeMux 却传给 ListenAndServe 的是 nil，导致路由不生效。

• 监听所有网卡：用 ":8080"，不是 "localhost:8080" 或 "127.0.0.1:8080"
• 注册路由必须在 ListenAndServe 之前，Go 不会动态重载路由表
• 如果要用自定义路由，传入非 nil 的 http.Handler，比如 http.ListenAndServe(":8080", myMux)

func main() {
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        w.WriteHeader(200)
        w.Write([]byte("Hello, Go HTTP"))
    })
    http.ListenAndServe(":8080", nil) // 注意第二个参数是 nil
}

处理 URL 路径参数和查询参数用 r.URL.Path 和 r.URL.Query()

Go 原生不支持类似 /user/:id 的路径匹配，http.ServeMux 只做前缀匹配。想取路径最后一段或解析 query，得手动操作字符串或用 url.ParseQuery。

使用场景：API 返回 JSON、根据 query 参数过滤列表、简单 REST 风格接口（如 /posts?id=123）。

• r.URL.Path 是原始路径字符串，带前导 /，需用 strings.TrimPrefix(r.URL.Path, "/") 提取资源名
• r.URL.Query().Get("page") 安全取值，返回空字符串而非 panic；r.URL.Query().Get("limit") 若未传，结果为空，别直接转 int
• 避免用 r.FormValue 混合处理 POST body 和 query —— 它会自动调用 ParseForm，对非表单请求（如 JSON）可能阻塞或出错

返回 JSON 时务必设置 Content-Type: application/json

很多初学者用 json.Marshal 序列化后直接 w.Write，浏览器或 curl 看起来“能用”，但实际响应头是 text/plain，前端 fetch().json() 会因 MIME 类型不匹配静默失败。

性能影响：不设 header 不影响吞吐，但兼容性差；某些代理或 CDN 可能根据 Content-Type 做缓存策略。

• 必须写：w.Header().Set("Content-Type", "application/json; charset=utf-8")
• 推荐用 http.Error(w, msg, statusCode) 处理错误响应，它会自动设 Content-Type: text/plain 并写状态码
• 不要在 WriteHeader 前调用 w.Write，否则 Go 会忽略你设的状态码，降级为 200

func apiHandler(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json; charset=utf-8")
    json.NewEncoder(w).Encode(map[string]string{"status": "ok"})
}

开发阶段用 net/http/pprof 查 CPU 和内存，别等上线才想起性能问题

pprof 是 Go 自带的诊断工具，但默认不暴露，需要显式注册 handler。它不依赖第三方包，几行代码就能接入，比临时加日志或重启服务查得快得多。

容易被忽略的地方：pprof 的 /debug/pprof/ 路由默认注册在 http.DefaultServeMux，如果你用了自定义 http.ServeMux 却没手动注册，就访问不到；另外，生产环境务必限制访问 IP 或加认证，别直接暴露。

• 开发期快速启用：import _ "net/http/pprof"，再确保 http.ListenAndServe 第二个参数是 nil
• 查看 goroutine 列表：curl http://localhost:8080/debug/pprof/goroutine?debug=1
• 采样 30 秒 CPU：curl -o cpu.pprof "http://localhost:8080/debug/pprof/profile?seconds=30"，然后用 go tool pprof cpu.pprof 分析

真正卡住人的往往不是语法，而是没意识到 http.ServeMux 的前缀匹配规则、没检查响应头、或者把开发期调试手段（如 pprof）留到线上才配——这些细节不写进代码里，光看文档根本记不住。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Go语言搭建简易HTTP服务教程》文章吧，也可关注golang学习网公众号了解相关技术文章。