net.ParseIP仅解析IP格式，不提供地理信息；必须结合GeoLite2.mmdb数据库与maxminddb库查询，注意文件格式、正确加载、结构体字段匹配及IPv6覆盖率。
为什么 net.ParseIP 不能直接返回地理位置？
因为 net.ParseIP 只做协议层解析（IPv4/IPv6 格式校验与标准化），不包含任何地理信息。它返回的是 net.IP 类型，本质是字节切片，和城市、国家、经纬度完全无关。想定位 IP，必须调用外部服务或加载本地 GeoIP 数据库。
用 maxminddb 读取 GeoLite2 数据库的实操要点
Go 生态最稳定的选择是 github.com/oschwald/maxminddb-golang，但容易踩几个坑：
- 数据库文件必须是
.mmdb格式（不是 CSV 或旧版.dat），从 MaxMind 官网下载 GeoLite2 City（免费版需注册） - 初始化时要用
maxminddb.Open，不是os.Open；关闭时必须显式调用db.Close()，否则文件句柄泄漏 - 查询结果结构体字段名严格匹配数据库 schema，比如城市名是
City.Names["en"]，不是City.Name；国家代码是Country.IsoCode - IPv6 地址能查，但部分免费数据库对 IPv6 覆盖率低，建议优先测试 IPv4
示例片段：
db, err := maxminddb.Open("GeoLite2-City.mmdb")
if err != nil {
log.Fatal(err)
}
defer db.Close()
var record struct {
City struct {
Names map[string]string `maxminddb:"names"`
} `maxminddb:"city"`
Country struct {
IsoCode string `maxminddb:"iso_code"`
} `maxminddb:"country"`
}
err = db.Lookup(net.ParseIP("8.8.8.8"), &record)
if err == nil {
fmt.Println(record.City.Names["en"], record.Country.IsoCode) // "Mountain View" "US"
}
HTTP API 方式调用时怎么避免超时和限流？
像 ipapi.co、ipgeolocation.io 这类服务，虽免配置但风险集中：
立即学习“go语言免费学习笔记（深入）”；
- 默认 HTTP client 没设超时，
http.DefaultClient可能卡死，务必自定义http.Client并设置Timeout（建议 ≤ 3s） - 多数免费 API 有每小时请求上限（如 ipapi.co 免费版 1000 次/日），没做本地缓存的话，重复查同一 IP 会快速耗尽配额
- 响应格式不统一：有的返回 JSON 直接含
country_name，有的是country对象嵌套code和name，必须按文档硬编码字段路径 - 别用 GET 拼 query 参数传 IP，某些服务要求 POST 或带特定 header（如
X-Api-Key）
如何让解析和定位逻辑不阻塞主流程？
IP 定位 IO 开销大，尤其走网络请求时，绝不能在 HTTP handler 里同步调用。正确做法是：
- 把定位逻辑抽成独立函数，接收
context.Context，支持主动取消 - 高频场景下加内存缓存（如
map[string]Location），用sync.RWMutex保护，TTL 建议设 1 小时——IP 归属极少实时变更 - 如果业务允许弱一致性，可异步写入（比如收到请求立刻返回基础 IP 信息，后台 goroutine 补充定位后更新 DB 或发消息）
- 别用全局变量存
*maxminddb.Reader或*http.Client，它们本身线程安全，但封装成单例时容易忽略资源释放时机
真实部署时，GeoIP 数据库更新频率低（月更），但忘记定期替换 .mmdb 文件会导致定位数据陈旧；API key 硬编码在代码里则存在泄露风险——这些细节比功能实现更难被发现。
