如何为Spring Boot应用创建正确的jlink自定义运行时镜像？

错误原因 #

java.lang.NoClassDefFoundError: java/beans/PropertyEditorSupport 说明你创建的自定义运行时镜像缺少了包含该类的模块。在Java 9+的模块化系统中，PropertyEditorSupport 属于 java.desktop 模块（原java.beans模块的内容已合并到此处），你之前的jlink命令未添加这个模块，导致运行时找不到类。

正确配置步骤 #

1. 用jdeps自动分析依赖模块 #

手动添加模块容易遗漏，推荐用jdeps工具自动扫描Spring Boot fat jar的模块依赖：

jdeps --multi-release 19 --print-module-deps --ignore-missing-deps demo-0.0.1-SNAPSHOT.jar

• --multi-release 19: 适配Spring Boot的多版本Java字节码（Spring Boot 3默认支持多版本）
• --print-module-deps: 仅输出需要的模块列表，直接用于jlink
• --ignore-missing-deps: 忽略可选依赖的缺失（Spring Boot包含一些可选依赖，不影响核心运行）

执行后会得到类似这样的模块列表：
java.base,java.desktop,java.logging,java.naming,java.sql

2. 重新构建自定义运行时镜像 #

将jdeps输出的模块列表传入jlink命令，同时添加优化参数减小镜像体积：

jlink --module-path $JAVA_HOME/jmods \
      --add-modules 你的jdeps输出模块列表 \
      --output mycustomrt \
      --strip-debug \
      --compress=2 \
      --no-header-files \
      --no-man-pages

• --strip-debug: 移除调试信息
• --compress=2: 启用最高级别压缩
• --no-header-files/--no-man-pages: 移除不必要的头文件和手册页

3. 验证运行 #

用自定义镜像的Java环境启动你的应用：

./mycustomrt/bin/java -jar demo-0.0.1-SNAPSHOT.jar

额外提示 #

Spring Boot 3官方推荐使用spring-boot-maven-plugin的build-image目标直接构建OCI镜像（基于Buildpacks），这种方式会自动处理依赖和运行时优化，比手动用jlink更简便。如果坚持用jlink，上述方法可以确保包含所有必要模块。

内容的提问来源于stack exchange，提问作者neblaz