http.ListenAndServe启动HTTP服务前必须检查端口是否被占、执行go mod tidy确保依赖完整、排查杀毒软件拦截；推荐显式使用http.NewServeMux管理路由并设置ReadTimeout/WriteTimeout超时，生产环境应避免裸用http.ListenAndServe。
http.ListenAndServe 启动服务前必须确认端口可用且模块已 tidy
直接运行 go run main.go 却打不开 localhost:8080？十有八九不是代码写错了，而是启动环节卡在了三处：端口被占（比如另一个 Go 进程或 Chrome 的调试端口）、go.mod 没执行 go mod tidy 导致依赖缺失、Windows 上杀毒软件静默拦截了监听行为。先跑 lsof -i :8080（macOS/Linux）或 netstat -ano | findstr :8080（Windows）看端口占用；再补一句 go mod tidy；最后临时关掉 Windows Defender 实时防护试试——别急着改路由逻辑，先把服务真正跑起来。
用 http.ServeMux 显式管理路由，避免全局污染
http.HandleFunc 看似简单，但所有注册都塞进 http.DefaultServeMux，测试难 mock，多人协作易冲突。显式创建 http.NewServeMux() 是更可控的做法：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 注册重复路径会 panic，错误信息是
http: multiple registrations for /path，提前暴露冲突 -
/api/这种带尾斜杠的写法才会匹配子路径（如/api/users），不带斜杠则只精确匹配 - 无法解析
/user/:id这类参数化路径，得靠框架或自己strings.Split(r.URL.Path, "/")切分
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/health", healthHandler)
mux.HandleFunc("/api/", apiHandler) // 注意结尾斜杠
http.ListenAndServe(":8080", mux)
}
http.Server 必须设超时，否则连接 hang 住不释放
裸调 http.ListenAndServe(":8080", nil) 没有读写超时，一个慢请求可能拖垮整个服务。生产环境至少要设 ReadTimeout 和 WriteTimeout：
立即学习“go语言免费学习笔记（深入）”；
-
ReadTimeout控制从连接建立到请求头读完的时间，建议 5–10 秒 -
WriteTimeout控制响应写入完成时间，一般略长于 ReadTimeout - 没有
http.Server结构体就无法调用Shutdown()，进程信号（如SIGTERM）来临时会直接 kill，正在处理的请求被中断
srv := &http.Server{
Addr: ":8080",
Handler: mux,
ReadTimeout: 5 * time.Second,
WriteTimeout: 10 * time.Second,
}
log.Fatal(srv.ListenAndServe())选 Gin 还是原生 net/http？看是否需要路径参数和中间件链
- 如果只是写健康检查、静态配置接口、内部工具页，
net/http+http.ServeMux完全够用，零依赖、启动快、内存低 - 一旦要写
/users/:id、/posts?limit=10、JWT 验证、日志中间件、跨域，gin的c.Param("id")、c.Query("limit")、Use()链式注册立刻省掉大量胶水代码 -
gin.Default()自带 logger 和 recovery 中间件，开发期方便，但生产需替换为自定义 logger 并关闭 recovery（避免泄露堆栈）
router := gin.New()
router.Use(logger(), authMiddleware())
router.GET("/users/:id", func(c *gin.Context) {
id := c.Param("id") // 不用手动解析 URL
c.JSON(200, gin.H{"id": id})
})原生 HTTP 服务器的灵活性藏在细节里：超时怎么设、路由怎么拆、错误怎么透出、信号怎么接——这些地方不填坑，上线后第一个流量高峰就会暴露。别迷信“一行启动”，真正的 Web 服务从来不在 main() 函数里结束。
