最简 HTTP 服务只需调用 http.ListenAndServe(":8080", nil)，它使用默认多路复用器 http.DefaultServeMux，注册路由须用 http.HandleFunc 且第二个参数为 nil；端口格式必须是 ":8080" 字符串，监听地址推荐 "0.0.0.0:8080" 以支持外部访问。
如何用 net/http 启动一个最简 HTTP 服务
只要调用 http.ListenAndServe 就能跑起来，不需要额外依赖或框架。它默认使用 http.DefaultServeMux 作为路由分发器，适合快速验证逻辑或写内部工具。
常见错误是端口被占用或忘记加冒号：":8080" 不能写成 8080 或 "8080"。
-
http.ListenAndServe第二个参数传nil表示使用默认多路复用器 - 监听地址必须是字符串格式，如
":8080"（监听所有网卡）或"127.0.0.1:8080"（仅本地） - 函数会阻塞，所以启动后需另起 goroutine 才能继续执行后续代码
package main
import (
"fmt"
"net/http"
)
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, "Hello, World!")
})
fmt.Println("Server starting on :8080")
http.ListenAndServe(":8080", nil)
}
为什么 http.HandleFunc 注册的路由不生效
本质是注册到了 http.DefaultServeMux，但如果你手动创建了 http.ServeMux 实例并传给 ListenAndServe，HandleFunc 就不会起作用——它只往默认实例里加规则。
典型场景：你想自定义路由逻辑，又误用了全局注册函数。
立即学习“go语言免费学习笔记（深入）”；
- 用
http.HandleFunc→ 必须配http.ListenAndServe(addr, nil) - 用自定义
http.ServeMux→ 必须用它的HandleFunc方法，不能用全局那个 - 路径匹配是前缀匹配，
"/api"会命中"/api/users"，注意末尾斜杠行为
如何处理 POST 请求和读取请求体
http.Request.Body 是 io.ReadCloser，必须显式关闭，否则连接可能无法复用，尤其在高并发下容易耗尽文件描述符。
另外，r.ParseForm() 或 r.ParseMultipartForm() 会自动调用 r.Body.Read，重复读会失败；想自己解析原始 body，得先 io.ReadAll(r.Body) 再 r.Body.Close()。
- 表单数据用
r.FormValue("key")，前提是已调用r.ParseForm() - JSON 请求体建议用
json.NewDecoder(r.Body).Decode(&v)，解码完 body 自动关闭 - 务必在 defer 中调用
r.Body.Close()，除非你确定只读一次且已消耗全部内容
func handlePost(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
return
}
defer r.Body.Close()
var data map[string]interface{}
if err := json.NewDecoder(r.Body).Decode(&data); err != nil {
http.Error(w, "Invalid JSON", http.StatusBadRequest)
return
}
fmt.Fprintf(w, "Received: %+v", data)
}
为什么本地能访问、部署后 502/连接拒绝
常见原因是没绑定到 0.0.0.0，而是绑定了 127.0.0.1 或 localhost。Docker 容器、云主机、反向代理（如 Nginx）无法通过回环地址访问你的服务。
另一个易忽略点：某些云平台（如 AWS EC2、阿里云 ECS）要求安全组/防火墙放行对应端口，光开 Go 程序端口没用。
- 监听地址写
":8080"（等价于"0.0.0.0:8080"），别写"127.0.0.1:8080" - 检查运行环境是否限制非 root 用户绑定低端口（如
:80），此时要改用:8080并配反代 - 容器中运行时，确认
EXPOSE和宿主机-p映射一致
net/http 足够轻量，但默认行为隐含不少假设，比如默认超时时间是永远、没有内置 CORS 支持、不自动处理 gzip——这些不是缺陷，而是设计取舍。真正在意稳定性或需要中间件能力时，才该考虑 chi、gorilla/mux 或 fasthttp 这类替代方案。 
