Golang使用nethttp构建简单API服务

最常见原因是监听地址写成了"localhost:8080"或"127.0.0.1:8080"，应改用":8080"监听所有接口；此外需检查端口占用、Docker映射、路由前缀匹配逻辑、JSON解析时机及生产环境应使用http.Server而非ListenAndServe。

为什么 http.ListenAndServe 启动后没报错却访问不了？

最常见原因是监听地址写成了 "localhost:8080" 或 "127.0.0.1:8080"，导致外部网络（包括 Docker 容器外、云服务器安全组外）无法连接。Go 的 net/http 默认只绑定到本地回环地址。

• 对外提供服务时，必须用 ":8080"（空主机名），表示监听所有可用网络接口
• 若端口被占用，http.ListenAndServe 会返回 "address already in use" 错误；但若监听成功却无响应，优先检查绑定地址
• 在 Docker 中运行时，还要确认 EXPOSE 和宿主机 -p 映射是否匹配

如何用 http.ServeMux 实现路径路由？

http.ServeMux 是 Go 标准库默认的 HTTP 路由器，支持前缀匹配而非完全匹配，这点容易引发意料外的行为。

• "/api" 会匹配 /api、/api/users、甚至 /apixxx —— 因为它只是字符串前缀判断
• 要精确匹配，需手动检查 r.URL.Path，或改用第三方路由器（如 gorilla/mux、chi）
• 注册顺序有影响：后注册的 handler 若前缀覆盖了前面的，可能“吃掉”本该由更具体规则处理的请求

怎么读取 JSON 请求体并避免 i/o timeout 或 invalid character？

直接调用 json.Decode(r.Body) 前，必须确保 r.Body 没被其他逻辑提前读取（比如日志中间件调用了 r.Body.Read 或 io.ReadAll），否则后续解码会得到空内容或 EOF。

baidu-map-jsapi-three

使用 MapV-Three 构建专业的 3D 地图和 GIS 应用 - 基于 Z-up 坐标系的 3D 地图库，支持地图编辑、测量工具、要素绘制、数据管理等地理可视化功能。适用于创建地图编辑器、测量工具、空间数据可视化等 Web-GIS 应用。

下载

• 务必在 handler 开头就处理请求体，不要依赖中间件自动解析
• 设置 r.Header.Get("Content-Type") 检查是否为 "application/json"，避免非 JSON 请求触发解析错误
• 使用 json.NewDecoder 而非 json.Unmarshal 可减少内存拷贝，但两者都要求 body 可读一次
• 超时通常来自客户端未发送完整 body，或服务端未设 http.Server.ReadTimeout

为什么生产环境不建议直接用 http.ListenAndServe？

标准 http.ListenAndServe 启动的 server 缺少对优雅关闭、超时控制、连接限制等关键生产特性的配置能力。一旦进程收到 SIGINT/SIGTERM，它会立即退出，正在处理的请求可能被中断。

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

• 必须用 http.Server 结构体显式构造，并设置 ReadTimeout、WriteTimeout、IdleTimeout
• 关闭时需调用 srv.Shutdown()，配合 context.WithTimeout 等待活跃连接完成
• 日志、panic 恢复、CORS、gzip 压缩等都需要自己封装中间件，标准库只提供最基础骨架

真正上线时，http.ListenAndServe 只适合原型验证——它掩盖了连接生命周期管理的复杂性。