net.parseip是校验ip格式最轻量可靠的方式，对非法格式如"192.168.1.256"返回nil而非panic；需先trimspace、去方括号，再判nil，之后用to4()/to16()区分版本。
用 net.ParseIP 判断输入是否为合法 IP 地址
用户传入的字符串不一定是有效 IP，直接丢给查询逻辑会 panic 或返回错误结果。必须先做格式校验。net.ParseIP 是最轻量、最可靠的方式——它能同时处理 IPv4 和 IPv6，且不依赖外部库。
注意：net.ParseIP 对非法格式（如 "192.168.1.256"、"192.168.1"）返回 nil，不是错误；别误以为它会抛异常。
- 只校验格式，不验证是否真实存在或可路由
- IPv6 地址带方括号（如
"[::1]"）需先去掉，否则net.ParseIP返回 nil - 若需区分 IPv4/IPv6，可用
ip.To4() != nil或ip.To16() != nil && len(ip) == 16
加载纯真 IP 库（QQWry.dat）时避免 mmap 失败
Go 生态中主流方案是用 qqwry-go 或 qqwry 包读取本地 QQWry.dat 文件。但实际部署时常见 mmap: invalid argument 错误，本质是文件打开模式或系统限制导致。
关键点：该库默认用 mmap 加载，但某些容器环境（如 Alpine Linux）或只读文件系统下不支持。必须显式降级为普通 os.Open + io.ReadFull 模式。
- 初始化时传入
qqwry.WithNoMmap()选项（具体名依包而定，如qqwry-go是qqwry.NewQQWry(qqwry.WithNoMmap())） - 确保
QQWry.dat文件权限为可读，且路径是绝对路径（相对路径在 daemon 模式下易失效） - 首次加载耗时约 50–200ms，建议在服务启动时完成，不要每次请求都
Open
HTTP 接口设计要防滥用和空响应
暴露一个 /ip?ip=xxx 接口看似简单，但线上运行很快会遇到问题：爬虫高频刷、参数缺失、IP 查不到却返回 200。
核心原则：查不到归属地 ≠ 成功，应明确区分「参数错误」「IP 格式错」「库中无记录」三类情况，并对应不同状态码和字段。
- 参数缺失或解析失败返回
400 Bad Request，body 含{"error": "invalid ip"} - IP 格式合法但库中无匹配（如私有地址、新分配段），返回
200 OK，但country和region设为空字符串，加"found": false字段 - 加简单限流，比如用
golang.org/x/time/rate对 /ip 路由限 100 QPS，防止资源耗尽 - 不要把原始
QQWry.dat路径或内部结构暴露在错误信息里（如 “open /data/qqwry.dat: no such file”）
并发查询时避免重复加载和锁竞争
QQWry.dat 解析后数据结构（通常是 trie 或索引数组）是只读的，但多个 goroutine 同时调用 Find 方法时，若实现没做好，可能因共享缓冲区或未同步的偏移计算出错。
实测发现部分旧版 qqwry 包的 Find 方法非并发安全——尤其在高并发下返回空或乱码。这不是 Go 的锅，是库作者没加 sync.Once 或没隔离临时 buffer。
- 优先选声明了 “safe for concurrent use” 的包，如较新版本的
github.com/oschwald/geoip2-golang（配合 MaxMind DB）更稳妥 - 若坚持用 QQWry，确认所用包的
Find方法接收的是值类型或已加读锁；否则自己包一层sync.RWMutex - 别在 handler 里 new 一个查询器，全局复用单例实例
IP 归属地本质是静态数据映射，真正的难点不在查询逻辑，而在数据更新机制、边界 case 处理和线上稳定性控制。比如 QQWry.dat 每月需手动更新，而 MaxMind DB 可自动下载；又比如 CDN 回源时 X-Forwarded-For 可能含多个 IP，得决定取第一个还是最后一个。
