如何使用ProGuard收缩Gradle ShadowJar生成的Fat Java Jar(Java 11环境)
根因定位
当前配置的两处核心缺陷直接导致大量类引用找不到的报错:
- Java 9及以上版本的JDK运行时类被拆分到独立的模块化jmod文件中,原配置仅加载了
java.base.jmod,java.sql、java.xml、java.logging等模块的类完全未被ProGuard纳入扫描范围,覆盖了你报错列表里的所有类 - 原配置引入的是停止维护的老版本ProGuard坐标,对Java 11的模块化路径处理存在兼容缺陷,且缺失程序入口、动态加载类的必要保留规则
修正后的完整可用配置
buildscript { dependencies { // 替换为官方持续维护的ProGuard依赖,解决Java 11兼容问题 classpath 'com.guardsquare:proguard-gradle:7.4.2' } } plugins { id 'java-library' id 'application' id 'com.github.johnrengelman.shadow' version '5.2.0' } sourceCompatibility = 11 targetCompatibility = 11 shadowJar { zip64 true } application { mainClassName = 'com.example.MyApp' } task proguard(type: proguard.gradle.ProGuardTask) { dependsOn shadowJar // 输入源:Shadow插件生成的Fat Jar,过滤掉模块描述文件 injars shadowJar, filter: '!module-info.class' // 输出路径:收缩后的最终Jar包 outjars "${buildDir}/libs/${project.name}-${project.version}-proguard.jar" // 基础行为配置:不混淆、不优化,仅执行类收缩 dontobfuscate dontoptimize // 抑制非致命的类引用警告(Fat Jar已包含全部项目业务依赖,不存在实际缺失类) dontwarn // 必须保留的类规则 // 1. 程序入口主类的main方法,保证Jar可正常启动 keep class 'com.example.MyApp' { public static void main(java.lang.String[]); } // 2. 所有需要动态加载的业务包,递归匹配子包、类、类成员,适配Class.forName调用场景 keep class 'com.example.packagetokeep.**' { *; } // JDK运行时库加载逻辑修正 def javaHome = System.getProperty('java.home') if (System.getProperty('java.version').startsWith('1.')) { // Java 8及以下版本的运行时类加载 libraryjars "${javaHome}/lib/rt.jar" libraryjars "${javaHome}/lib/jce.jar" } else { // Java 9及以上版本:遍历加载jmods目录下所有模块文件,过滤模块描述文件 fileTree("${javaHome}/jmods") { include '*.jmod' }.each { jmodFile -> libraryjars jmodFile.absolutePath, jarfilter: '!**.jar', filter: '!module-info.class' } } }
配置调整说明
- 老的
net.sf.proguard坐标已停止维护,最高版本仅能适配Java 8,替换为官方维护的新坐标后,可正常解析Java 11的模块化路径结构 - JDK库加载逻辑从单文件引入改为全量遍历jmods目录,覆盖所有内置模块的类引用,从根源上解决
can't find referenced class的报错 - 原来的保留规则
com.example.packagetokeep.*仅匹配当前层级包下的直接类,替换为带**的递归匹配规则后,会保留所有子包下的类、方法、字段,完全适配动态类加载的需求 - 补充了主类入口的保留规则,避免收缩操作移除程序启动必需的main方法
- 增加的
dontwarn规则会跳过扫描过程中对缺失类的致命校验,因为输入已经是包含全部业务依赖的Fat Jar,实际运行时不存在类缺失问题
内容的提问来源于stack exchange,提问作者John
相关产品推荐
相关产品推荐

