Linux系统安装Sikulix setup 1.1.3 jar包失败报错问题求助

核心报错诱因 #

• 安装命令书写错误：执行命令时jar包文件名带空格未转义、未补全.jar后缀，JVM无法正确加载安装包
• Java版本不兼容：Sikulix 1.1.3仅支持Java 8/9版本，使用JDK 11及以上高版本会触发本地库调用、类加载异常
• 系统本地依赖缺失：Linux环境未预装OpenCV、X11图形组件、libwmf、libxtst等依赖库时，Sikulix核心的图像识别、输入模拟功能无法初始化
• 安装包损坏：下载过程中网络异常导致jar包核心文件缺失，哈希校验不通过
• 无可用图形环境：纯命令行的无桌面服务器环境未配置虚拟显示，Sikulix无法完成屏幕相关组件初始化

分步修复方案 #

1. 修正安装命令
   先确认下载的安装包完整文件名，官方发布的1.1.3版本安装包默认名称为sikulixsetup-1.1.3.jar，执行安装时不要拆分文件名，正确命令如下：
   java -jar sikulixsetup-1.1.3.jar
   如果本地重命名后文件名保留空格，需要给文件名加双引号识别：
   java -jar "Sikulix setup 1.1.3.jar"

2. 适配Java版本
   先执行java -version查看当前默认Java版本，如果版本高于9，需要安装JDK8并切换默认版本：

# Debian/Ubuntu系安装命令
sudo apt install openjdk-8-jdk
# 切换系统默认Java版本
sudo update-alternatives --config java
# 选择对应openjdk-8的选项后确认即可

RPM系（CentOS/RHEL/Fedora）可通过dnf/yum安装java-1.8.0-openjdk-devel后再切换版本。

3. 安装系统依赖
   Debian/Ubuntu系执行以下命令安装全部前置依赖：

sudo apt update
sudo apt install libopencv-dev libwmf0.2-7 x11-apps libxtst-dev

RPM系对应安装opencv-devel、libwmf、libXtst-devel、xorg-x11-apps包即可。

4. 无桌面环境适配
   如果是无图形界面的服务器场景，先安装Xvfb虚拟显示服务，启动虚拟桌面后再执行安装：

sudo apt install xvfb
Xvfb :1 -screen 0 1280x720x24 &
export DISPLAY=:1

5. 安装包校验
   如果以上步骤操作后仍报错，删除本地安装包重新下载，下载完成后核对官方公布的SHA校验值，确认安装包无损坏后再重试安装。

排查优先查看报错提示的错误日志，日志会明确标记加载失败的具体库文件或类名，可直接根据日志提示补全对应缺失组件。

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