直接用 r.remoteaddr 拿不到真实客户端 ip，因其返回的是上游代理地址；需结合信任代理列表解析 x-real-ip 或可信段内 x-forwarded-for 最右非私有 ip。
为什么直接用 net/http 的 r.RemoteAddr 拿不到真实客户端 IP
微服务通常部署在 Nginx、Traefik 或 Kubernetes Ingress 后面，r.RemoteAddr 返回的是上游代理的地址（比如 10.42.0.1:54321），不是用户真实出口 IP。必须从请求头中提取，但不同代理设置的头字段不统一：X-Forwarded-For 可能被伪造，X-Real-IP 不一定存在，CF-Connecting-IP 仅 Cloudflare 有效。
正确做法是结合信任的代理列表 + 多级头解析。Go 标准库不提供开箱即用方案，需手动实现或借助中间件（如 gorilla/handlers.ForwardedHeaders）。但要注意：若未配置信任代理，X-Forwarded-For 最左 IP 可能是恶意构造的。
- 确认你的入口网关（如 Nginx）已配置
set_real_ip_from和real_ip_header X-Forwarded-For - 在 Go 服务中只信任来自内网段（如
10.0.0.0/8、172.16.0.0/12）的代理传来的头 - 推荐用
httputil.DetectContentType类似思路自己写一个getRealIP(r *http.Request)，优先检查X-Real-IP，再 fallback 到可信段内的X-Forwarded-For最右非私有 IP
加载 GeoIP2 数据库时 maxminddb.Open 报 invalid database 怎么办
常见原因是下载了错误格式的数据库 —— GeoIP2 提供 .tar.gz 压缩包，里面包含多个文件（GeoLite2-City.mmdb、GeoLite2-Country.mmdb 等），但 maxminddb 库只认解压后的 .mmdb 文件本身，不能直接打开压缩包或目录。
另一个坑是文件权限：如果用 Docker 部署，挂载的 .mmdb 文件在容器内不可读（比如 host 上是 root 写入，容器以非 root 用户运行），会静默失败或报错 permission denied，而非明确的格式错误。
- 下载后解压，确认路径指向的是
GeoLite2-City.mmdb（不是GeoLite2-City_20240401/GeoLite2-City.mmdb这种嵌套路径） - 用
file GeoLite2-City.mmdb检查是否输出MaxMind DB字样，否则说明没解压或损坏 - Docker 中加
RUN chmod 644 /app/GeoLite2-City.mmdb，或挂载时指定 uid/gid - 避免每次请求都
Open：全局复用一个*maxminddb.Reader实例，它线程安全
调用 reader.City 返回 geoip2.City 但 Country.IsoCode 为空
这不是 bug，而是数据精度问题。City 数据库对某些 IP（尤其是内网、运营商 NAT 地址、新分配 IPv6）可能只定位到国家或更粗粒度。即使查询成功，Country、City、Location 都可能是 nil 或字段为空。
更麻烦的是：同一个 IP 在不同时间查询结果可能不同（数据库更新、IP 归属变更），且 MaxMind 对免费版 GeoLite2 明确声明“accuracy is not guaranteed”。不要把它当权威地理坐标源用，尤其不能用于风控决策。
- 始终检查
err != nil，再检查city.Country.IsoCode != ""，再检查city.City.Names["en"] != "" - 对空结果建议 fallback 到默认值（如
"ZZ"表示未知国家），而不是 panic 或返回 500 - 如果需要高精度（比如展示城市名），考虑加一层缓存 + 异步刷新机制，避免重复查相同 IP
- 注意时区字段
city.Location.TimeZone是字符串（如"Asia/Shanghai"），不是偏移量，别直接转成time.FixedZone
在 Gin/Echo 中注入 IP 定位结果时如何避免阻塞和内存泄漏
GeoIP2 查询本质是二进制文件随机读取，单次耗时约 0.1–0.5ms，看似无害。但若每个请求都同步查一次，QPS 上千时会成为瓶颈；更危险的是，如果忘记关闭 maxminddb.Reader，进程退出时文件句柄不释放，Docker 容器重启后可能因句柄耗尽而 crash。
中间件里直接调用 reader.City 很方便，但容易忽略上下文超时和错误传播。例如用户传了个非法 IP（::1 或空字符串），reader.City 会返回 error: invalid IP address，若不处理，整个请求链路就断了。
- 用
context.WithTimeout(ctx, 10*time.Millisecond)包裹查询，超时直接返回默认定位信息 - Gin 中用
c.Set("geo", geoData)注入，Echo 用c.Set("geo", geoData)，别存指针或大结构体 - 应用启动时初始化
maxminddb.Reader，shutdown 时调用reader.Close()（Gin 可用graceful shutdown钩子，Echo 用e.Shutdown()） - 别把
*maxminddb.Reader存在 request context 里 —— 它是全局资源，不是 per-request
最常被忽略的是数据库更新策略：MaxMind 每月发布新版，但你的服务可能几个月没重启，还在读旧文件。得配个定时任务检测 mtime 变更，或用 inotify 监听文件变化后热重载 Reader。这事没人替你做。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
