最稳方案是使用 oschwald/maxminddb-golang 库，全局单例初始化 reader，优先 Country 查询，IP 需归一化并校验有效性，中文名取 Names["zh"]，注意文件权限与热更新安全。
用 maxminddb 读取 GeoLite2 数据库最稳
Go 生态里能直接解析 MaxMind GeoLite2 / GeoIP2 格式（即 .mmdb）的库，oschwald/maxminddb-golang 是事实标准。其他封装或自解析方案要么不支持新版格式，要么漏掉嵌套字段（比如 country.names.zh），上线后查不到中文名就懵了。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
go get github.com/oschwald/maxminddb-golang安装，别用 fork 或旧版maxmind/geoip-api-golang（已归档，不支持 GeoLite2） -
.mmdb文件必须是 GeoLite2-City 或 GeoLite2-Country，免费版下载地址是https://dev.maxmind.com/geoip/geolite2-free-geolocation-data?lang=en，注意要注册账号、接受许可协议才能拿到下载链接 - 加载时用
maxminddb.Open()，不是os.Open()—— 后者只打开文件句柄，没法做内存映射查询，性能差一个数量级 - 查完记得调用
reader.Close()，否则文件句柄泄漏，高并发下会报too many open files
查 IP 时别硬编码 net.IP 解析逻辑
很多人直接用 net.ParseIP() 后丢给 reader.City()，但没处理代理头（如 X-Forwarded-For）、IPv6 嵌入 IPv4 地址（::ffff:192.0.2.1）、或私有网段（127.0.0.1, 10.0.0.0/8）—— 这些 IP 查出来全是空结构体或 panic。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先用
net.ParseIP()，再用ip.To4()或ip.To16()统一转成标准格式，避免net.IP内部字节数组长度不一致导致匹配失败 - 加一层校验：用
ip.IsGlobalUnicast()排掉本地回环、链路本地、文档地址等无效 IP；私有网段可配合privateNet.Contains(ip)（提前定义好*net.IPNet切片） - HTTP 请求中取客户端 IP，优先读
X-Real-IP，其次X-Forwarded-For的第一个非私有 IP，别无脑取头里第一个值
City 和 Country 查询结果字段差异大
查 reader.City(ip) 返回结构体字段多（含城市、邮政码、经纬度、时区），但内存占用高、耗时略长；reader.Country(ip) 只返回国家代码和名称，快且轻量。选错会导致接口 P99 延迟翻倍，尤其在低配容器里。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 如果业务只要国家归属（比如灰度开关、语言自动切换），用
Country—— 它比City快 30%~50%，且.mmdb文件小一半 -
City结构体里的Names是map[string]string，中文名键是"zh"，不是"zh-CN"或"cn"，取不到就 fallback 到"en" - 经纬度字段叫
Location.Latitude和Location.Longitude，不是Lat/Lng，别按惯性命名去点
API 并发查 IP 时容易触发 maxminddb 的 goroutine 泄漏
常见错误是每个请求都 maxminddb.Open() 一次，又不 Close —— .mmdb 底层用了 mmap，每个 reader 占一个虚拟内存段，几十个并发就 OOM。还有人用 sync.Pool 缓存 reader，但 maxminddb.Reader 不是线程安全的，Pool 复用会 panic。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 全局只初始化一个
*maxminddb.Reader，启动时Open()，进程退出前Close() - 查 IP 是纯读操作，
reader.City()/reader.Country()本身并发安全，不用加锁或池化 - 如果真要热更新数据库（比如每天自动下载新
.mmdb），得用双 reader + 原子指针切换，别边读边Close()原 reader
GeoIP 查询看着简单，真正卡住人的永远是 mmdb 文件权限、IPv6 归一化、以及那个藏在 Names["zh"] 里的中文名——它不报错，只是静默返回空字符串。
