Java应用通过Apache GeoIP模块在日志中添加地理位置信息，本质是Apache解析IP并注入地理字段，Java仅从请求头（如X-GeoIP-City）读取；需配置mod_geoip2、GeoLite2数据库及请求头透传，Spring Boot中用getHeader获取；云环境可改用Java版GeoIP2 API。
Java应用中通过Apache的GeoIP模块在日志中添加地理位置信息，本质是借助Apache HTTP Server（而非Java本身）解析客户端IP并注入地理字段，再由Java应用（如Servlet、Spring Boot）从请求头中读取这些字段。关键点在于：GeoIP功能由Apache提供，Java只负责消费。
Apache端配置GeoIP模块
确保已安装并启用mod_geoip2（推荐）或旧版mod_geoip，并下载MaxMind GeoLite2 City数据库：
- 下载GeoLite2-City.mmdb到服务器（如/usr/share/GeoIP/GeoLite2-City.mmdb）
- 在httpd.conf或虚拟主机配置中加入：
LoadModule geoip2_module modules/mod_geoip2.so
GeoIP2Enable On
GeoIP2File /usr/share/GeoIP/GeoLite2-City.mmdb
GeoIP2Cookie On
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %{GeoIP2_CITY_NAME}e %{GeoIP2_COUNTRY_NAME}e" geoip_combined
CustomLog logs/access_geoip.log geoip_combined
上述配置会将城市名和国家名写入Apache访问日志，并通过X-GeoIP-City、X-GeoIP-Country等响应头（或环境变量）透传给后端Java应用。
Java应用获取地理位置字段
若Java应用部署在Apache后方（如通过mod_proxy或AJP），需确保Apache将GeoIP字段作为请求头转发：
立即学习“Java免费学习笔记（深入）”；
- 在Apache配置中添加：RequestHeader set X-GeoIP-City "%{GEOIP2_CITY_NAME}e"
- 在Java中通过HttpServletRequest.getHeader("X-GeoIP-City")获取城市名
- 同理可取X-GeoIP-Country、X-GeoIP-Latitude、X-GeoIP-Longitude等
Spring Boot示例（Controller中）：
@GetMapping("/api/location")
public Map<String, String> getLocation(HttpServletRequest request) {
Map<String, String> loc = new HashMap<>();
loc.put("city", request.getHeader("X-GeoIP-City"));
loc.put("country", request.getHeader("X-GeoIP-Country"));
return loc;
}
注意事项与常见问题
实际使用中需注意以下几点：
- 确保Apache以反向代理方式运行，且ProxyPreserveHost On开启，避免原始IP丢失
- GeoIP2依赖真实客户端IP，若经多层代理（如Nginx→Apache→Java），需在最外层设置X-Forwarded-For，并在Apache中用RemoteIPHeader X-Forwarded-For识别真实IP
- GeoLite2免费库精度有限，城市级定位误差可能达数十公里；商用场景建议升级至GeoLite2 Premium或MaxMind GeoIP2 Precision服务
- Java端不建议自行加载.mmdb文件做IP查询——这会重复Apache已做的工作，且难以保持数据同步和性能一致
替代方案：纯Java实现（不依赖Apache）
若无法控制Apache配置（如云托管环境），可在Java中直接集成MaxMind GeoIP2 API：
- Maven引入：com.maxmind.geoip2:geoip2:3.0.0
- 下载GeoLite2-City.mmdb并加载为DatabaseReader
- 根据request.getRemoteAddr()查询地理位置
- 优点：完全可控；缺点：增加JVM内存占用、需自行管理数据库更新和线程安全
这种方式绕过了Apache，但失去了日志原生嵌入地理字段的便利性，适合轻量级或边缘部署场景。
