C#如何解析IP归属地_C#本地离线库与第三方API查询【实用】

直接用第三方 API 是最省心、最可靠的选择；本地离线库只适合有明确合规或断网需求的场景，但极易踩坑。下面把三种主流方案的实现细节和关键陷阱一次说透。

用 HttpClient 调 ipapi.co 最简可行方案

免费、无需 key、支持 IPv4/IPv6、返回结构清晰——这算是当前（2026 年）最稳的 HTTP 接口了：

• https://ipapi.co/{ip}/json/ 返回标准 JSON，关键字段包括 city、region_name、country_name、org（运营商）
• 必须设超时：client.Timeout = TimeSpan.FromSeconds(5)，否则 DNS 卡住会拖垮整个请求线程
• 检查状态码再解析：if (response.StatusCode == HttpStatusCode.OK)，别直接 EnsureSuccessStatusCode()——429（限频）或 503 时会抛异常，真实问题反而被掩盖
• 内网 IP（如 192.168.x.x）、Docker 网桥地址、CDN 回源 IP 常返回空或“Private Range”，这不是代码 bug，是数据源本身没收录

加载 qqwry.dat 必须全内存映射，不能每次 new FileStream

纯真库不是普通文件，它是靠偏移跳转的二进制结构。多线程下用 FileStream 直接读，Seek() 位置互相覆盖，结果城市变空或乱码：

• 启动时一次性读入内存：byte[] data = File.ReadAllBytes("qqwry.dat")，后续所有查询基于这个 byte[] 操作
• 索引区起始偏移不是固定的 0x100，要从文件末尾往前找第一个 0x1A 字节，再读其前 4 字节才是索引头地址
• 解析时遇到 0x01 表示国家字段重定向，需跳到指定偏移再读；遇到 0x02 则固定从 0x100 开始读国家名——漏掉这两个处理，org 字段永远为空
• 编码必须用 Encoding.GetEncoding("GB18030")，Encoding.Default 在 Linux 容器或 VS Code 终端里大概率出问号

GeoLite2-City.mmdb 需官方库，但免费版不含 ISP 数据

MaxMind 官方方案最规范，但别被“免费下载”几个字误导：

• NuGet 安装 GeoIP2（它已包含 MaxMind.Db），别只装后者——手动解析 mmdb 格式极其容易出岔子
• reader.City(ip).City.Name 可取城市名，但 reader.Isp(ip).Isp 在免费版中会抛 NotSupportedException：GeoLite2 免费库明确不提供 ISP 字段
• 数据库文件路径必须存在且进程有读权限；若部署在 IIS 或 Linux systemd 服务里，常因工作目录不对导致 FileNotFoundException
• IPv6 查询完全支持，但注意传入的是 IPAddress 实例，不是字符串——IPAddress.Parse("::1") 才合法

真正难的不是调通某个接口，而是理解每种方案的边界：API 有调频和网络依赖，qqwry.dat 解析逻辑脆弱且不支持 IPv6，GeoLite2 免费版缺关键字段。选哪个，取决于你敢为哪类失败兜底。