c.ClientIP()返回127.0.0.1或内网IP，根本原因是Gin默认只信任直连请求；若前端存在Nginx、Cloudflare等代理，必须显式调用SetTrustedProxies配置可信代理网段，并配合Nginx正确透传X-Real-IP和X-Forwarded-For头，否则将 fallback 到RemoteAddr（即代理内网IP）。
为什么c.ClientIP()返回的总是127.0.0.1或内网IP
直接调用c.ClientIP()拿不到真实用户IP，根本原因是Gin默认只信任直连请求。只要前面有Nginx、Cloudflare或K8s Ingress这类代理，就必须显式配置可信代理段，否则它会从X-Forwarded-For头里取错位置，甚至 fallback 到RemoteAddr（即代理本机地址）。
实操建议：
- 初始化引擎后立刻调用
r.SetTrustedProxies([]string{"10.0.0.0/8", "192.168.0.0/16", "173.245.48.0/20"})，填入你实际的负载均衡/CDN网段 - Nginx配置中必须包含
proxy_set_header X-Real-IP $remote_addr;和proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; - 验证方式：在中间件里打印
c.Request.Header.Get("X-Forwarded-For")和c.ClientIP()，二者应一致且非10.x/192.168.x段
用geoip2本地解析IP归属地，不走HTTP API
调用ipapi.co或ipinfo.io这类在线服务，会引入网络延迟、配额限制和单点故障——尤其在高并发鉴权场景下，一次权限校验若要等200ms+的HTTP roundtrip，整个链路就废了。
更稳的做法是本地加载MaxMind的GeoLite2-City.mmdb，用github.com/oschwald/geoip2-golang离线解析：
- 下载数据库文件（注意：MaxMind自2024年起要求注册账号并接受新许可协议才能下载）
- 启动时一次性加载到内存：
db, _ := geoip2.Open("/path/to/GeoLite2-City.mmdb")，后续所有查询都是纯内存操作 - 解析耗时稳定在
50–100μs量级，比HTTP请求快2000倍以上 - 注意：不要在每次请求里
Open文件，那是IO瓶颈；也不要漏掉defer db.Close()
归属地结果该缓存到Redis还是Badger
IP地理位置本身变化极慢（用户不会每分钟换城市），但解析结果若每次都查mmdb，仍存在重复计算开销。是否缓存、缓存多久、存在哪，取决于部署形态：
- 单机部署（如小B端SaaS）：用
github.com/dgraph-io/badger，数据落盘、重启不丢、无网络依赖，适合缓存IP → {country, city, timezone}这类结构化小数据 - 多实例集群（如微服务架构）：必须用Redis，靠
SET ip:1.2.3.4 "{...}" EX 86400统一key空间，避免各节点重复解析同一IP - 别缓存“失败结果”：对私有IP（如
192.168.1.100）、保留地址、解析报错的IP，不写缓存，防止污染 - TTL设为24小时足够——地理库本身更新频率也就在周级
中间件里怎么把IP归属地透传给业务Handler
归属地信息不能只打印日志，得让后续Handler能拿到。Gin的*gin.Context提供了c.Set()/c.Get()机制，但要注意生命周期和类型安全：
- 在中间件里解析完后，调用
c.Set("geo", geoData)，其中geoData是自定义struct，比如type Geo struct{ Country string; City string } - Handler中用
v, ok := c.Get("geo")取出，再断言if ok { geo := v.(Geo) }，避免panic - 别用
c.Request.Context().WithValue()——那属于net/http底层，Gin的c对象已封装好，用Set/Get语义更清晰、性能更好 - 如果多个中间件都要读这个值，建议封装一个
GetGeo(c *gin.Context) (Geo, bool)工具函数，统一处理nil和类型断言
真正容易被忽略的是IP可信链的完整性：哪怕你用了最准的GeoLite2库，只要SetTrustedProxies漏了一段内网网段，或者Nginx没透传X-Real-IP，后面所有归属地判断都建立在错误输入上。定位问题时，先盯死c.ClientIP()输出，再谈缓存和解析。
