maxminddb 是当前最靠谱的 Go GeoIP 库，因其纯 Go 实现、无 CGO 依赖、跨平台、更新及时且为 MMDB 格式事实标准；需用 github.com/oschwald/maxminddb-golang，正确加载 .mmdb 文件并复用 Reader。
为什么 maxminddb 是当前最靠谱的 Go GeoIP 库
Go 生态里能稳定读取 MMDB 格式（MaxMind 官方格式）的库，maxminddb 是事实标准。它不依赖 CGO，纯 Go 实现，跨平台编译无压力，且更新及时——官方 DB 格式一变，它通常一周内就跟进兼容。
常见错误是误用 geoip2（需要 CGO + libmaxminddb）或已归档的 go-geoip，后者不支持新版 DB，查 IPv6 会 panic 或返回空结构。
- 必须用
github.com/oschwald/maxminddb-golang，别拼错包名 - DB 文件必须是 .mmdb 后缀，.dat 或 .bin 会打开失败，报错
invalid database format - IPv4 和 IPv6 查询走同一接口，但传入
net.IP时得确保是完整 16 字节（IPv6）或 4 字节（IPv4），用ip.To16()最安全
如何正确加载 DB 并查出城市+经纬度
加载不是简单 os.Open，必须用 maxminddb.Open，它内部做了内存映射和格式校验；直接读文件内容再解析会崩溃。
查字段也不能硬写 City.Name 这种路径——MMDB 是嵌套 map 结构，字段存在性不确定，必须用 decoder.Decode + 类型断言，否则 panic。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- DB 文件路径传给
maxminddb.Open，返回 *maxminddb.Reader，记得defer db.Close() - 查 IP 用
db.City(ip)（返回*City）或更通用的db.Lookup(ip, &result) - 城市名要判空：
if city.City != nil && city.City.Names != nil { name := city.City.Names["en"] } - 经纬度在
city.Location里，Latitude/Longitude是 float64，注意精度丢失风险
var city maxminddb.City
err := db.Lookup(net.ParseIP("8.8.8.8"), &city)
if err != nil {
log.Fatal(err)
}
if city.City != nil && city.City.Names != nil {
fmt.Println(city.City.Names["en"]) // "Mountain View"
}
查不到数据？先确认这三件事
90% 的“查不到”不是代码问题，而是数据源或输入本身不匹配。
- 免费版
GeoLite2-City.mmdb不包含所有 IP 段，尤其国内小运营商、教育网、云厂商私有段基本空白——别拿阿里云内网 IP 去查 - 传入的
net.IP必须是 IPv4 或 IPv6 地址字节形式，"127.0.0.1"字符串会解析失败，得用net.ParseIP("127.0.0.1") - DB 文件权限要可读，Linux 下如果用
go run直接执行，当前工作目录可能不是 DB 所在目录，路径要用绝对路径或filepath.Join拼接
性能关键：复用 Reader，别每次查都重开 DB
maxminddb.Reader 是线程安全的，可以全局复用。反复 Open + Close 不仅慢（每次 mmap 开销），还会触发文件句柄泄漏，压测时容易 too many open files。
- 启动时一次
maxminddb.Open，存到全局变量或注入到 struct 中 - HTTP 服务场景下，把
*maxminddb.Reader作为 handler 闭包变量或依赖传入，不要在每个请求里打开 - DB 文件更新后，需重建
Reader实例（旧实例不会自动 reload），建议加文件监听或定期轮询 mtime
复杂点在于 DB 更新时机和热替换逻辑——没做原子替换的话，中间几秒可能查到旧数据或 panic，这个得自己兜底。
