http.ListenAndServe 是 Go 启动 HTTP 服务的核心函数，必须配对 http.HandleFunc 注册路由，且端口格式需为 ":8080"；若仅注册未调用、端口错误或绑定 127.0.0.1 则导致启动失败、静默退出或外部无法访问。
直接用 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 没提供退出接口，信号捕获、连接等待、超时强制终止这些都得自己补全，一不留神就变成无法优雅下线的黑盒服务。
