GraphDB 10.1.4执行GeoSPARQL查询报NoClassDefFoundError求助

原因分析与修复步骤 #

1. 检查GeoSPARQL依赖库完整性 #

GraphDB 10.1.x版本更新了GeoSPARQL组件的依赖，com.useekm.geosparql.UnitsOfMeasure类属于useekm的GeoSPARQL库，升级时可能出现jar包缺失或损坏：

• 停止GraphDB服务
• 定位到GraphDB安装目录的lib文件夹，确认存在useekm-geosparql-*.jar文件（版本需匹配10.1.4的依赖）
• 若文件缺失/版本不符，从官方完整安装包的lib目录中复制对应jar文件替换现有文件
• 重启服务后重新测试查询

2. 验证仓库GeoSPARQL配置 #

升级后仓库的GeoSPARQL配置可能异常：

• 打开GraphDB工作台，进入目标仓库的设置页面
• 找到GeoSPARQL选项，确保已勾选"Enable GeoSPARQL support"
• 若空间索引异常，执行以下SPARQL重建索引：

PREFIX ontogeo: <http://www.ontotext.com/owlim/geo#>
INSERT DATA { ontogeo:createIndex _:b1 . }

3. 清理缓存与调整JVM参数 #

JVM缓存或元空间不足可能导致类初始化失败：

• 停止GraphDB，删除安装目录下work文件夹中的缓存文件（注意备份数据）
• 启动时添加JVM参数：-XX:+UseParallelGC -XX:MaxMetaspaceSize=512m，避免元空间不足影响类加载

4. 干净重装GraphDB #

若上述步骤无效，可能是升级过程中文件损坏：

• 备份所有仓库数据
• 完全卸载当前10.1.4版本
• 下载官方完整安装包进行全新安装
• 恢复数据后测试GeoSPARQL查询

测试验证 #

执行以下官方示例查询验证修复效果：

PREFIX geo: <http://www.opengis.net/ont/geosparql#>
PREFIX geof: <http://www.opengis.net/def/function/geosparql/>
PREFIX sf: <http://www.opengis.net/ont/sf#>

SELECT ?f
WHERE {
  ?f a sf:Polygon .
  ?f geo:hasGeometry ?g .
  ?g geo:asWKT ?wkt .
  FILTER (geof:sfContains(?wkt, "POINT(1.0 1.0)"^^geo:wktLiteral))
}

确认查询返回结果且日志无UnitsOfMeasure相关错误。

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