Skip to content

地区数据 ​

SYS-AREA-01 | 模块 system | 提供省市县树与 IP 归属地解析,供地址选择与登录地展示使用。

1. 使用角色与场景 ​

角色:终端用户、开发者

  • 表单选择所在城市
  • 登录日志显示 IP 归属地

2. 接口与权限点 ​

方法路径权限点摘要代码行
GET/system/area/tree—获得地区树AreaController#L29
GET/system/area/get-by-ip—获得 IP 对应的地区名AreaController#L37
GET/system/area/tree—获得地区树AppAreaController#L27

3. 代码定位 ​

层位置
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/ip/AreaController.java#L29
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/app/ip/AppAreaController.java#L27

4. 数据表 ​

无独立表,数据存于缓存、文件或配置。

5. 机制与配置 ​

  • 内置 area.csv 与 ip2region.xdb,不依赖数据库表
  • 启动时加载为内存树

6. 常见问题与排查 ​

  • xdb 文件缺失时 IP 解析降级为空,不报错

7. 关联 ​