IntelliJ中Gradle项目带本地库打包Jar运行报错排查

一、先解决「找不到主类」的核心问题 #

命令行执行java -jar时，VM参数（比如-Djava.library.path）的位置必须放在-jar前面——否则会被当成JAR包的运行参数，而非虚拟机参数。正确的命令格式应该是：

java -Djava.library.path="D:\path-to-gradle-project\libs\SimpleITK-2.3.0" -jar your-jar-file-name.jar

你之前大概率把-D参数放在了-jar后面，导致JVM无法识别VM参数，同时打乱了主类的查找逻辑，触发找不到主类的错误。

二、检查Gradle的Jar配置是否正确 #

打开你的build.gradle，重点确认两个点：

1. 主类配置是否缺失 #

Jar任务必须在manifest中声明Main-Class属性，否则JVM不知道要启动哪个类。示例配置：

jar {
    manifest {
        attributes 'Main-Class': 'com.yourpackage.YourMainClass' // 替换成你的主类全限定名
    }
}

IDEA能正常运行是因为它会自动识别主类，但命令行执行java -jar必须依赖这个配置。

2. 依赖打包是否完整 #

SimpleITKJava包含Java绑定和本地库，如果你只打包了自己的代码，没包含SimpleITK的Java类，运行时会出现依赖缺失。可以用shadowJar插件生成包含所有依赖的可执行Jar（fat jar）：

• 先在build.gradle顶部引入插件：

  plugins {
      id 'java'
      id 'com.github.johnrengelman.shadow' version '8.1.1' // 版本可按需调整
  }
  

• 配置shadowJar的主类：

  shadowJar {
      manifest {
          attributes 'Main-Class': 'com.yourpackage.YourMainClass'
      }
  }
  

• 执行gradle shadowJar生成fat jar，路径在build/libs/xxx-all.jar，再用正确的命令行参数运行这个Jar。

三、本地库路径的命令行注意事项 #

• Windows下路径如果包含空格，引号要正确包裹；如果没有空格，建议去掉引号，避免解析问题。
• 确认D:\path-to-gradle-project\libs\SimpleITK-2.3.0路径下确实存在SimpleITK的本地库文件（比如.dll），路径拼写不要出错。

四、验证步骤 #

1. 按照正确顺序调整命令行参数，重新执行java -D... -jar ...。
2. 检查build.gradle中的Jar配置，确保Main-Class正确设置。
3. 若存在依赖缺失，用shadowJar生成fat jar后再测试运行。

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