核心是依赖分析而非手动删减:先用jdeps精准识别应用所需模块(如java.base、java.logging),再通过jlink --module-path $java_home/jmods --add-modules指定模块自动生成最小闭包运行时,配合--strip-debug、--compress=2等参数优化体积与启动性能。

用 jlink 裁剪出体积最小的 Java 运行环境,核心不是“全删”,而是“只留必需”。它依赖 Java 9+ 的模块系统,从 JDK 的 jmods 目录中精准组装应用真实需要的模块,跳过 IDE 工具、文档、GUI 支持、调试器等服务器/容器场景完全用不到的部分。最终生成一个可直接执行的精简目录(如 myjre/),不依赖宿主机 JDK,也不修改你的代码。
第一步:准确识别应用真正依赖的 JDK 模块
盲目指定 --add-modules 极易漏模块,导致运行时报 NoClassDefFoundError 或 Module not found。必须靠 jdeps 分析:
- 若项目有
module-info.java,直接运行:jdeps --list-deps your-app.jar
输出如java.base java.logging java.xml就是显式依赖 - 若为传统非模块化应用(绝大多数 Spring Boot 项目),用:
jdeps --multi-release 17 --print-module-deps your-app.jar
注意--multi-release版本需与你构建/运行环境一致(如 JDK 17 就写 17) - 对反射、动态加载类等隐式依赖,加参数进一步探测:
jdeps --ignore-missing-deps --verbose:class your-app.jar 2>&1 | grep "class not found"
再结合报错类名反查所属模块(例如javax.swing.*属于java.desktop)
第二步:用 jlink 构建最小化运行时目录
拿到模块列表后,调用 jlink 合并 JDK 模块和你的依赖库:
- 基础命令示例:
jlink --module-path $JAVA_HOME/jmods:libs --add-modules java.base,java.logging,java.xml --output myjre -
--module-path必须包含两部分:JDK 的jmods目录(路径如/usr/lib/jvm/jdk-17/jmods)和你项目的第三方 jar 所在目录(如libs/) - 关键瘦身参数不能少:
•--compress=2:启用字节码压缩,体积再降 15–25%
•--strip-debug:移除所有调试符号
•--no-header-files --no-man-pages:彻底剔除开发/文档文件,服务器完全无用
第三步:集成进 Docker 多阶段构建(推荐上线流程)
手动构建的 myjre/ 只是中间产物,生产应嵌入 Dockerfile 自动化:
-
构建阶段(builder):用完整 JDK 镜像(如
eclipse-temurin:17-jdk-jammy)编译代码、运行jlink,输出myjre/和应用 jar -
运行阶段(runtime):基于
scratch或debian:slim,仅 COPY--from=builder复制myjre/和 jar,再ENTRYPOINT ["./myjre/bin/java", "-jar", "app.jar"] - 这样最终镜像不含 javac、jstack、locale 数据、man 页面等任何冗余,实测常压至 50–80MB,Spring Boot 应用甚至可到 30MB 以内
第四步:验证裁剪是否安全可用
体积小不是唯一目标,稳定运行才是底线:
- 启动时加 JVM 参数观察模块加载:
./myjre/bin/java -Xlog:module*=info -jar app.jar
检查日志中是否出现Skipping module、not found或Unable to load module - 覆盖全部业务路径测试:特别是登录、文件上传、定时任务、HTTP 客户端调用等易触发动态类加载的环节
- 若报错,回退到
jdeps输出,补上对应模块重试;常见需追加的模块包括:java.naming(JNDI)、java.sql(数据库驱动)、jdk.unsupported(部分老框架反射调用)
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











