Go语言HTTP服务常见卡点是go mod初始化失败、http.ListenAndServe后404或连接拒绝、路由未生效；需检查GO111MODULE=on、module path规范、精确路径匹配、端口监听地址及防火墙。
go mod 初始化失败、http.ListenAndServe 启动后访问 404 或连接被拒绝、以及路由未生效却误以为代码有 bug。下面直奔实操关键环节。
确认 Go 安装并验证 GOPATH/GOROOT 是否干扰
现代 Go（1.16+）默认启用模块模式，GOROOT 通常自动设置，但手动配置过 GO111MODULE=off 或残留旧版 GOPATH 项目会干扰新项目初始化。
- 运行
go version确认 ≥ 1.18（2026 年推荐用 1.21+） - 执行
go env GOPATH GOROOT GO111MODULE，检查输出中GO111MODULE应为on；若为auto或off，运行go env -w GO111MODULE=on - 避免在
$GOPATH/src下新建项目——这会强制进入 legacy 模式，导致go mod init生成错误的 module path
初始化模块时 module path 必须可解析
go mod init 的参数不是随便起的目录名，而是未来 import 路径的根。写成 go mod init myapi 看似简单，但一旦后续要引入本地包或发布到私有仓库，就会因路径冲突报错。
- 推荐用域名反写形式，例如你 GitHub 用户名是
alice，就用go mod init github.com/alice/myapi - 若纯本地开发暂无域名，可用
go mod init local/myapi，但需确保所有import语句与之严格匹配 - 初始化后检查
go.mod文件第一行：module github.com/alice/myapi—— 这个值将决定其他包如何 import 你的代码
net/http 路由注册后仍 404？检查 HandlerFunc 是否覆盖根路径
用标准库写 API 最容易忽略的是：如果注册了 http.HandleFunc("/api/users", handler)，但没注册 / 或没设 http.DefaultServeMux 的 fallback，访问 http://localhost:8080/ 就会返回 404，而非你预期的 /api/users。
-
http.HandleFunc是向http.DefaultServeMux注册，它只响应**精确匹配**的路径前缀，不支持通配或嵌套路由 - 测试时务必访问完整路径，例如
curl http://localhost:8080/api/users，而不是/ - 如需更灵活的路由（比如
/api/users/:id），必须换用gorilla/mux或gin；标准库不支持路径参数提取 - 启动服务前加日志：
fmt.Printf("Serving on :8080\n")，避免因端口被占而静默失败
启动服务后浏览器打不开？重点查端口与防火墙
http.ListenAndServe(":8080", nil) 启动成功不代表你能从浏览器访问——它默认只监听 localhost（即 127.0.0.1），且某些系统（如 macOS Monterey+）会拦截 127.0.0.1:8080 的 HTTP 请求，或 Windows 防火墙阻止入站连接。
立即学习“go语言免费学习笔记（深入）”；
- 先用
curl -v http://localhost:8080/api/users测试，比浏览器更可靠 - 若 curl 也失败，运行
lsof -i :8080（macOS/Linux）或netstat -ano | findstr :8080（Windows）确认端口是否真被占用 - 想让局域网其他设备访问，改用
http.ListenAndServe("0.0.0.0:8080", nil)，但仅限开发环境 - Mac 用户若遇到 “Connection refused”，尝试关闭「Web Sharing」或检查「Private Relay」是否干扰本地 loopback
fmt.Println("hello") 在浏览器里显示不出来。 
