Gradle构建Jar包启动时出现NoClassDefFoundError问题求助

我来帮你搞定这个Jar运行时的依赖问题，结合你描述的场景——IDE里跑正常、打包后报错，还有ControlsFX和JDOM2的依赖，整理了几个关键的排查和修复步骤：

1. 先把MANIFEST.MF的Class-Path格式修好！ #

你提到Class-Path里的依赖项没有空格分隔，这绝对是问题之一！JVM识别Class-Path的规则是每个依赖Jar之间必须用空格隔开，比如正确的格式应该是：

Class-Path: controlsfx-8.40.14.jar jdom2-2.0.6.jar openjfx-78-backport-compat.jar

如果没有空格，JVM会把整个字符串当成一个完整的路径，自然找不到对应的依赖Jar，这肯定会抛出找不到类的错误。

2. 改用Fat Jar打包（最省心的方案） #

瘦Jar（只包含自己代码的Jar）需要手动维护Class-Path，很容易踩坑。更稳妥的方式是把所有依赖都打包到一个Jar里，也就是Fat Jar，这样运行时不用管依赖路径，直接跑就行。

方式一：用Shadow插件（推荐，简单高效） #

1. 先在build.gradle的plugins块里加上Shadow插件（选适配Java 8的版本）：

plugins {
    id 'java'
    id 'com.github.johnrengelman.shadow' version '7.1.2'
}

2. 配置你的主类路径（替换成你自己的主类全限定名）：

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

3. 执行打包命令：

./gradlew shadowJar

生成的Fat Jar在build/libs/目录下，名字一般是你的项目名-all.jar，直接运行这个Jar就好：

java -jar build/libs/your-project-name-all.jar

方式二：手动配置Jar任务（不用插件） #

如果不想用插件，也可以手动写Gradle配置来打包依赖：

jar {
    manifest {
        attributes 'Main-Class': 'com.your.package.YourMainClass'
    }
    // 将所有依赖的内容打包进Jar
    from {
        configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) }
    }
    // 排除签名文件，避免多个Jar的签名冲突
    exclude 'META-INF/*.SF', 'META-INF/*.DSA', 'META-INF/*.RSA'
}

执行./gradlew jar后，生成的Jar就是包含所有依赖的Fat Jar了。

3. 确认JavaFX内部API的访问权限 #

Java 8默认是允许访问com.sun.javafx这类内部API的，但如果你的启动命令里加了--illegal-access=deny这类限制参数，会导致JVM拒绝加载这个类。运行Jar时就用最基础的命令：

java -jar your-jar-file.jar

别加那些额外的非法访问限制参数。

4. 检查ControlsFX版本是否适配Java 8 #

ControlsFX的版本要和Java 8匹配，建议用专门为Java 8做的稳定版，比如8.40.14，在build.gradle里明确指定：

dependencies {
    implementation 'org.controlsfx:controlsfx:8.40.14'
    implementation 'org.jdom:jdom2:2.0.6'
    // 如果你需要backport依赖，也要确认它的版本和Java 8兼容
    implementation 'org.openjfx:openjfx-78-backport-compat:11.0.2'
}

最后验证一下 #

1. 重新打包后，解压Jar看看：如果是Fat Jar，应该能在里面找到com/sun/javafx/scene/control/skin/BehaviorSkinBase.class；如果是瘦Jar，确认Class-Path里的依赖Jar确实包含这个类。
2. 运行Jar时，确保依赖Jar和MANIFEST里的名字完全一致，而且放在正确的路径下（如果用相对路径的话，要和Jar在同一目录或者对应相对位置）。

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