You need to enable JavaScript to run this app. 如何使用ProGuard收缩Gradle ShadowJar生成的Fat Java Jar(Java 11环境)
优惠活动
大模型
产品
解决方案
定价
更多

如何使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 22:54:05