Gradle Java项目怎么打成jar包-java教程-PHP中文网

Gradle默认jar任务只打包项目自身.class文件，不含第三方依赖，故java -jar运行会因NoClassDefFoundError失败；需通过shadow插件生成fat jar或配置Class-Path分离依赖并指定Main-Class方可执行。

gradle java项目怎么打成jar包

直接打 gradle jar 生成的 jar 默认不含依赖，也不能直接用 java -jar 运行——这是绝大多数人第一次打包就踩坑的地方。

默认 `jar` 任务只打项目自身 class 文件

Gradle 的内置 jar 任务（来自 java 插件）默认行为很“干净”：只把 src/main/java 编译出的 .class 和 src/main/resources 下的资源打进 jar，完全不碰任何依赖。

运行 gradle jar 后，输出在 build/libs/-.jar
这个 jar 没有 Class-Path，也没有把第三方 jar 解压进去
如果主类依赖了 gson 或 slf4j，直接 java -jar xxx.jar 会报 NoClassDefFoundError
它适合做 SDK 库发布（比如供其他项目 implementation 引入），不适合当可执行程序分发

要可执行，必须显式配置 `Main-Class` 和依赖处理方式

可执行 jar 的核心是两件事：声明入口类、让 JVM 能加载到所有依赖。Gradle 不自动做后者，得手动选策略。

Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

方案一（推荐新手）：用 shadow 插件打 fat jar
加这段到 build.gradle：

plugins {
    id 'com.github.johnrengelman.shadow' version '8.1.1''

}
shadowJar {
    archiveClassifier = ''
    manifest {
        attributes 'Main-Class': 'com.example.Main'
    }
}

然后运行 gradle shadowJar，输出 build/libs/--all.jar，直接 java -jar 就行

方案二：保留依赖分离，靠 MANIFEST.MF 的 Class-Path
适合依赖稳定、想避免每次重打大 jar 的场景。需额外任务复制依赖：

task copyLibs(type: Copy) {
    from configurations.runtimeClasspath
    into 'build/libs/lib'
}
jar {
    dependsOn copyLibs
    manifest {
        attributes 'Main-Class': 'com.example.Main'
        attributes 'Class-Path': configurations.runtimeClasspath.files.collect { "lib/${it.name}" }.join(' ')
    }
}

注意：Class-Path 值里不能有空格或特殊字符，路径必须是相对路径（lib/xxx.jar），且 jar 运行时当前目录得是 build/libs

`configurations.*` 选错会导致依赖漏打或签名失败

很多人抄配置时把 configurations.runtimeClasspath 写成 configurations.compile 或 configurations.implementation，结果要么打不全（缺 runtime-only 依赖），要么打不进（compileOnly 依赖根本没参与打包）。

runtimeClasspath 是最稳妥的选择：它包含编译 + 运行时所有实际参与 classpath 的 jar
如果用了 shadow 插件，它内部默认就用 runtimeClasspath，不用手动改
若项目含已签名的 jar（如某些商业 SDK），用 zipTree(it) 解压合并会破坏签名，触发 SecurityException: Invalid signature file digest；此时只能选「依赖分离」方案，或手动排除签名文件（不推荐）
打 big jar 时可能遇到 archive contains more than 65535 entries 错误，必须加 zip64 = true（shadowJar 默认已启用，自定义 jar 任务需显式写）