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

用 jlink 裁剪 JDK 模块,核心不是“删文件”,而是让工具自动算出最小依赖闭包,只打包应用真正需要的模块。整个过程分两步:先分析依赖,再构建镜像。不改代码、不装额外工具,JDK 9+ 自带就能做。
第一步:准确识别你用到了哪些 JDK 模块
盲目指定 --add-modules 容易漏模块(运行时报 NoClassDefFoundError)或带进冗余模块(比如 java.desktop)。必须靠 jdeps 分析:
- 如果你的应用已模块化(有
module-info.class),直接运行:jdeps --list-deps your-app.jar
它会列出显式声明的依赖,如java.base、java.logging - 如果是传统 jar(无
module-info),用:jdeps --multi-release 17 --print-module-deps your-app.jar
注意把17换成你实际编译/运行的 JDK 版本 - 想查反射、动态加载等运行时才触发的类所属模块,加参数:
--verbose:class --ignore-missing-deps
能帮你发现java.naming或jdk.unsupported这类容易被忽略的模块
第二步:用 jlink 构建精简运行时
拿到模块列表后,调用 jlink 合并 JDK 模块和你的依赖:
Java项目代码review工具。分析Git变更+完整调用链路上下文,推断业务需求,进行多维度评分和分类汇总,生成完整PRD文档。包含细粒度Java代码审查清单(Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 基础命令示例:
jlink --module-path $JAVA_HOME/jmods --add-modules java.base,java.logging,java.xml --output myjre -
--module-path必须包含 JDK 的jmods目录(常见路径是$JAVA_HOME/jmods);如果用了第三方 jar,也得加进来,比如:--module-path $JAVA_HOME/jmods:libs/ - 常用优化参数:
•--strip-debug:去掉调试符号
•--compress=2:压缩类字节码
•--no-header-files --no-man-pages:剔除开发用文件 - 生成的
myjre/是一个完整可执行目录,含bin/java,可直接在没装 JDK 的机器上运行
关键细节和常见误区
模块不能“部分裁剪”——只要加了 java.desktop,整个模块(包括 javax.swing、java.awt、音频等子系统)都会被打包进来。所以排除方式很简单:不用就别写进 --add-modules。
- 纯命令行 HTTP 服务,通常只需:
java.base、java.logging、java.net.http(替代老式javax.net.ssl) - Spring Boot 类框架常需反射和代理,建议加上:
java.management、jdk.management;若用到 JMX,再加java.rmi - JavaFX 应用要额外把 OpenJFX 的
lib/加入--module-path,并显式添加javafx.controls等模块,同时加--bind-services确保内部服务可用
集成到容器镜像中更实用
在 Dockerfile 中用多阶段构建最干净:
- 构建阶段用完整 JDK +
jlink生成myjre/ - 运行阶段用
scratch或alpine基础镜像,只 COPYmyjre/和你的 jar - 典型体积效果:从完整 JDK 的 1.5GB → 压缩到 50–80MB,启动更快,内存占用更低
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










