配置带Protege SWRL规则推理机的Fuseki服务器遇类缺失错误

错误信息 #

Exception in initialization: org/apache/jena/reasoner/BaseInfGraph$InfFindSafeCapabilities
21:48:48 WARN WebAppContext :: Failed startup of context oeje10w.WebAppContext@6eb089e6{Apache Jena Fuseki Server,/,b=file:///C:/Users/admin/Downloads/apache-jena-fuseki-5.0.0-rc1/webapp/,a=AVAILABLE,h=oeje10s.SessionHandler@715a70e9{STARTED}}
java.lang.NoClassDefFoundError: org/apache/jena/reasoner/BaseInfGraph$InfFindSafeCapabilities

背景与排查情况 #

• 目标：为Apache Jena Fuseki 5.0.0-rc1配置支持Protege导出SWRL规则的推理机，参考教程操作后触发初始化异常
• 当前配置：Openllet 2.6.5的jar包放置路径为apache-jena-fuseki-5.0.0-rc1\lib\original-openllet-distribution-2.6.5.jar
• 已尝试操作：
  • 将配置文件中的tdb前缀改为tdb2、切换为内存ttl模型，服务可正常启动，但无法使用SWRL规则
  • 移除推理机相关配置后服务正常运行，但失去SWRL推理能力
• 怀疑方向：jar包位置/版本兼容问题、配置文件错误、启动脚本异常

解决方案 #

1. 版本兼容修复（核心原因） #

Fuseki 5.x属于Jena 5.x版本，而Openllet 2.6.5基于旧版Jena（如Jena 3.x）开发，BaseInfGraph$InfFindSafeCapabilities类在Jena 5.x中已被移除或重构，导致类找不到错误。

两种解决路径：

• 降级Fuseki版本：改用Jena Fuseki 3.x系列稳定版（推荐3.17.0及以上），与Openllet 2.6.5完全兼容
• 升级Openllet版本：下载适配Jena 5.x的Openllet最新版（如3.0.0+），替换现有jar包

2. 配置文件修正（针对Jena 3.x+Openllet 2.6.5组合） #

若使用TDB2存储，需调整配置文件中的前缀与对应声明：

@prefix : <#> .
@prefix fuseki: <http://jena.apache.org/fuseki#> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix tdb2: <http://jena.apache.org/2016/tdb#> .
@prefix ja: <http://jena.hpl.hp.com/2005/11/Assembler#> .

[] rdf:type fuseki:Server ;
fuseki:services (
<#service1>
) .

[] ja:loadClass "org.apache.jena.tdb2.TDB2" .
tdb2:DatasetTDB2 rdfs:subClassOf ja:RDFDataset .
tdb2:GraphTDB2 rdfs:subClassOf ja:Model .

<#service1> rdf:type fuseki:Service ;
fuseki:name "FireDSS" ;
fuseki:serviceQuery "query" ;
fuseki:serviceQuery "sparql" ;
fuseki:serviceUpdate "update" ;
fuseki:serviceUpload "upload" ;
fuseki:serviceReadWriteGraphStore "data" ;
fuseki:serviceReadGraphStore "get" ;
fuseki:dataset <#dataset> .

<#dataset> rdf:type ja:RDFDataset ;
ja:defaultGraph <#model_inf> .

<#model_inf> a ja:InfModel ;
ja:baseModel <#tdbGraph> ;
ja:reasoner [
ja:reasonerClass "openllet.jena.PelletReasonerFactory" ;
] .

<#tdbGraph> rdf:type tdb2:GraphTDB2 ;
tdb2:dataset <#tdbDataset> .

<#tdbDataset> rdf:type tdb2:DatasetTDB2 ;
tdb2:location "TDB2" ;
ja:context [ ja:cxtName "arq:queryTimeout" ; ja:cxtValue "0" ] .

3. jar包与启动脚本检查 #

• 替换original-openllet-distribution-2.6.5.jar为完整的Openllet二进制发行版jar包（避免使用带original-前缀的源码jar）
• 当前fuseki-server.bat的类路径配置java -Xmx1200M -cp fuseki-server.jar;lib/* org.apache.jena.fuseki.cmd.FusekiCmd %*无问题，无需修改

兼容Protege SWRL规则的替代推理机 #

• HermiT：原生支持SWRL，提供Jena集成版本，与各版本Jena兼容性良好，配置时只需将推理机类改为org.semanticweb.HermiT.ReasonerFactory
• Stardog（免费版可用）：原生支持SWRL，自带推理引擎，无需额外配置，与Protege导出的SWRL规则兼容性极高
• Drools：可通过Jena集成实现SWRL推理，适合复杂规则场景，但配置流程相对繁琐

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