如何使用golang启动一个web服务器？

本文共计760个文字，预计阅读时间需要4分钟。

使用`net/http`即可启动Web服务，无需框架和外部库。一行代码`http.ListenAndServe`就足够了。但必须配置`http.HandleFunc`或显式路由注册，否则未处理的请求将无人响应。

为什么 http.ListenAndServe 启动不了？

最常见原因是只注册了路由，却忘了调用启动函数；或者端口格式写错导致 panic。

• http.HandleFunc("/", handler) 只是注册，不启动服务，后续没跟 http.ListenAndServe 就静默退出
• 端口字符串必须带冒号，比如 ":8080"，写成 "8080" 会 panic： listen tcp: address 8080: missing port in address
• 端口被占用时错误是 listen tcp :8080: bind: address already in use，需换端口或杀掉旧进程
• http.ListenAndServe 是阻塞调用，后面代码不会执行；如果想加日志或清理逻辑，得把它放在最后，或另起 goroutine（但注意错误捕获）

怎么安全返回 JSON 而不是乱码？

Go 的 http.ResponseWriter 默认 Content-Type 是 text/plain; charset=utf-8，直接 json.Marshal 写进去浏览器会当文本解析，中文可能变问号，前端 fetch().json() 也会失败。

• 必须手动设置头：w.Header().Set("Content-Type", "application/json; charset=utf-8")
• 结构体字段要首字母大写，否则 json.Marshal 序列化出来是空对象 {}
• 别用 fmt.Fprintf(w, "%s", b) 输出 JSON 字节，容易漏转义；直接 w.Write(b) 更稳妥

func jsonHandler(w http.ResponseWriter, r *http.Request) { w.Header().Set("Content-Type", "application/json; charset=utf-8") data := map[string]string{"msg": "ok", "time": "2026-04-23"} b, _ := json.Marshal(data) w.Write(b) }

为什么本地能跑，部署后访问不到？

默认 http.ListenAndServe(":8080", nil) 绑定的是 127.0.0.1:8080，只接受本机回环请求。云服务器或 Docker 容器里，外部流量进不来。

立即学习“go语言免费学习笔记（深入）”；

• 改成 http.ListenAndServe("0.0.0.0:8080", nil) 才监听所有网卡（注意防火墙和安全组放行该端口）
• Docker 中记得 EXPOSE 8080 并用 -p 8080:8080 映射
• 生产环境别裸用 nil 第二个参数，应构造 http.Server 实例，设 ReadTimeout/WriteTimeout，否则慢请求会拖垮整个服务

真正麻烦的不是“怎么开启”，而是“怎么关”——ListenAndServe 没提供退出接口，信号捕获、连接等待、超时强制终止这些都得自己补全，一不留神就变成无法优雅下线的黑盒服务。