运行Apache Jena的sparql CLI工具时遇“找不到主类arq.sparql”错误如何解决？

问题描述 #

按照Apache Jena官方文档执行以下操作后：

sudo apt install openjdk-22-jre
wget https://dlcdn.apache.org/jena/binaries/apache-jena-4.10.0.zip
wget https://dlcdn.apache.org/jena/source/jena-4.10.0-source-release.zip
unzip apache-jena-4.10.0.zip
cd jena-4.10.0
export JENA_HOME="$(pwd)"
export PATH="$PATH:$(pwd)/apache-jena/bin"

运行sparql命令时出现错误：

Error: Could not find or load main class arq.sparql
Caused by: java.lang.ClassNotFoundException: arq.sparql

解决步骤 #

1. 修正PATH环境变量 #

解压后的apache-jena-4.10.0目录中，bin文件夹直接位于根目录，并非嵌套在apache-jena子目录下。你之前的PATH路径配置错误，正确设置应为：

export PATH="$PATH:$(pwd)/bin"

可先执行ls命令确认当前目录结构，正常应显示bin、lib等核心文件夹。

2. 调整Java版本 #

Apache Jena 4.10.0对Java 22的兼容性不佳，推荐使用Java 11或17（长期支持版本）。执行以下命令切换Java版本：

sudo apt install openjdk-17-jre
sudo update-alternatives --config java

在弹出的选项中选择Java 17，之后重新尝试运行sparql命令。

3. 清理冗余文件 #

你下载的jena-4.10.0-source-release.zip是源码包，运行工具无需依赖它，可删除避免目录混淆：

rm jena-4.10.0-source-release.zip

4. 持久化环境变量（可选） #

若希望每次登录系统都自动加载Jena环境变量，可将配置写入~/.bashrc（或~/.zshrc，取决于你使用的shell）：

echo "export JENA_HOME=$(pwd)" >> ~/.bashrc
echo "export PATH=\$PATH:\$JENA_HOME/bin" >> ~/.bashrc
source ~/.bashrc

验证配置 #

执行以下命令验证是否配置成功：

sparql --version

若能正常输出Apache Jena ARQ的版本信息，则说明问题已解决。

内容的提问来源于stack exchange，提问作者Ciro Santilli OurBigBook.com