使用GeoTools gt-wfs-ng 25.2从WFS获取要素时空指针异常如何解决

问题根因确认 #

你的猜测完全正确，该空指针异常就是目标WFS服务返回的GetCapabilities响应中缺失Filter_Capabilities节点导致的。gt-wfs-ng 25.2版本的过滤器拆分逻辑未做空值兼容处理，读取服务端空间过滤能力配置时直接访问了空对象，触发了NPE。

基于GeoTools的规避方案 #

• 方案一：强制过滤器本地执行。在构造Query时添加配置query.setHandleFiltered(true)，或在连接参数中新增connectionParams.put("WFSDataStoreFactory:FILTER_CAPABILITIES", "client-side-only")，绕过服务端过滤能力校验逻辑，所有过滤操作都在客户端完成，不会触发空指针。
• 方案二：更换GeoTools版本。该BUG为25.x版本的已知问题，你可以升级到26.2及以上版本，官方已在后续版本补充了SpatialCapabilitiesImpl的空值判断；也可降级到24.x长期稳定版，该版本不存在该异常。
• 方案三：重写过滤器拆分逻辑。如果必须使用25.2版本，可以继承AbstractWFSStrategy类，重写splitFilters方法，调用父类逻辑前手动初始化空的SpatialCapabilities实例注入到能力配置中，即可规避空指针。

其他Java开源库备选方案 #

如果不想修改GeoTools逻辑，也可以选择绕开WFSDataStore的封装：

• 手动构造WFS请求：用HttpClient直接发送GetFeature请求，拿到GML或GeoJSON格式的响应后，用GeoTools内置的GMLParser或FeatureJSON工具直接解析为要素集合，完全跳过GetCapabilities的解析和能力校验逻辑，适配规范度低的WFS服务。
• 使用deegree WFS客户端：deegree的WFS客户端对不规范WFS服务的兼容度更高，不会强制要求Filter_Capabilities节点存在，可直接构造查询请求拉取要素。

内容的提问来源于stack exchange，提问作者makak