本文旨在指导读者如何为基于Java 19和Spring Boot 3.0的Maven项目创建最小化的自定义运行时镜像。我们将探讨使用`jdeps`分析依赖的局限性，并解决在使用`jlink`构建自定义运行时时常见的`NoClassDefFoundError`，特别是针对`java.beans.PropertyEditorSupport`的缺失问题，最终提供一个包含必要模块的正确`jlink`命令。
简介：Java模块化与自定义运行时
Java平台模块系统（JPMS），自Java 9引入，旨在提高应用的可靠性、安全性，并允许创建更小、更高效的运行时镜像。jlink工具是JPMS的核心组件之一，它能够根据应用程序实际所需的模块来构建一个定制的JRE，从而显著减小部署包的大小。这对于微服务、容器化部署以及资源受限的环境尤其有价值。
然而，对于非模块化或混合模块化（如Spring Boot应用，通常打包为包含所有依赖的“fat JAR”）的应用，确定其所需的完整JDK模块集可能具有挑战性。Spring Boot应用由于其广泛的依赖和内部机制，往往会隐式地依赖JDK中的多个模块。
Spring Boot 应用示例与初始问题
我们从一个使用start.spring.io创建的简单Spring Boot应用开始，配置如下：
立即学习“Java免费学习笔记（深入）”；
- 构建工具: Maven
- Java版本: Java 19
- Spring Boot版本: 3.0
- 额外依赖: commons-lang3
pom.xml配置示例：
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.0.0</version>
<relativePath/>
</parent>
<groupId>com.example</groupId>
<artifactId>demo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>demo</name>
<description>Demo project for Spring Boot</description>
<properties>
<java.version>19</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>主应用类 DemoApplication.java 如下：
package com.example.demo;
import org.apache.commons.lang3.StringUtils;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
String mix = "MIX";
if (StringUtils.isNoneBlank(mix)) {
System.out.println(mix);
}
SpringApplication.run(DemoApplication.class, args);
}
}编译并打包后，可以通过 java -jar target/demo-0.0.1-SNAPSHOT.jar 成功运行。
使用 jdeps 分析依赖与遇到的挑战
为了创建自定义运行时，第一步通常是使用jdeps工具分析应用程序的模块依赖。对打包后的Spring Boot fat JAR执行jdeps命令：
jdeps target/demo-0.0.1-SNAPSHOT.jar
输出会显示许多内部依赖以及对java.base和java.logging的依赖，但也会有大量的not found或指向demo-0.0.1-SNAPSHOT.jar本身的条目。例如：
demo-0.0.1-SNAPSHOT.jar -> java.base demo-0.0.1-SNAPSHOT.jar -> java.logging demo-0.0.1-SNAPSHOT.jar -> not found com.example.demo -> java.io java.base com.example.demo -> java.lang java.base com.example.demo -> org.apache.commons.lang3 not found com.example.demo -> org.springframework.boot not found # ... (大量输出)
这里的“not found”通常意味着jdeps无法在当前类路径或模块路径中找到对应的模块，这对于Spring Boot的fat JAR是常见的，因为其内部包含了所有依赖，而jdeps在分析时可能无法完全解析这些嵌套的依赖。因此，仅仅依赖jdeps对fat JAR的直接输出，可能无法准确识别所有必要的JDK模块。
初次尝试 jlink 及运行时错误
基于jdeps的部分输出，我们可能初步尝试使用java.base和java.logging模块来构建自定义运行时：
jlink --module-path $JAVA_HOME/jmods --add-modules java.base,java.logging --output mycustomrt
此命令会成功创建一个名为mycustomrt的自定义JRE。然而，当尝试使用这个自定义JRE运行Spring Boot应用时：
mycustomrt/bin/java -jar target/demo-0.0.1-SNAPSHOT.jar
应用程序会抛出java.lang.NoClassDefFoundError: java/beans/PropertyEditorSupport错误，并导致应用启动失败。
java.lang.NoClassDefFoundError: java/beans/PropertyEditorSupport
at java.base/java.lang.ClassLoader.defineClass1(Native Method)
# ... (堆栈信息)
Caused by: java.lang.ClassNotFoundException: java.beans.PropertyEditorSupport
# ... (堆栈信息)这个错误表明，尽管我们添加了java.base和java.logging，但Spring Boot应用程序（或其某个依赖）还需要其他JDK模块，其中包含java.beans.PropertyEditorSupport类。
识别并添加缺失的模块
java.beans.PropertyEditorSupport类位于java.desktop模块中。虽然我们的Spring Boot应用可能没有直接使用图形界面（GUI），但java.beans包中的类，如PropertyEditorSupport，经常被框架用于属性绑定、配置处理和内省机制，即使在无头（headless）服务器环境中也是如此。
此外，Spring Boot应用及其依赖可能还会用到其他一些JDK模块，即使它们在jdeps的初始分析中不明显：
- java.xml: 用于XML处理，许多配置或数据格式化可能需要。
- java.sql: 用于JDBC和数据库连接，即使没有直接配置数据库，一些数据抽象层也可能依赖它。
- java.prefs: 用于用户或系统偏好设置，某些库可能使用它进行配置存储。
综合考虑这些潜在的依赖，我们需要将这些模块也添加到jlink命令中。
解决方案：构建包含完整模块的自定义运行时
正确的jlink命令应包含java.base、java.logging以及我们通过错误信息和经验判断出的java.xml、java.sql、java.prefs和java.desktop模块。
执行以下命令创建自定义运行时：
jlink --module-path $JAVA_HOME/jmods \
--add-modules java.base,java.logging,java.xml,java.sql,java.prefs,java.desktop \
--output mycustomrt命令解释:
- --module-path $JAVA_HOME/jmods: 指定JDK模块的查找路径。
- --add-modules ...: 明确指定需要包含在自定义运行时中的模块。
- --output mycustomrt: 指定生成的自定义运行时镜像的输出目录名称。
创建成功后，再次尝试使用这个新的自定义运行时来运行Spring Boot应用程序：
./mycustomrt/bin/java -jar target/demo-0.0.1-SNAPSHOT.jar
此时，应用程序应该能够正常启动并运行，不再出现NoClassDefFoundError。
总结与注意事项
为Spring Boot应用创建自定义运行时是一个优化部署的重要手段，但需要注意以下几点：
- jdeps的局限性: 对于Spring Boot的fat JAR，jdeps可能无法完全揭示所有必要的JDK模块依赖。这通常需要结合运行时错误信息和经验来补充。
- 迭代过程: 寻找最小化模块集可能是一个迭代的过程。从java.base开始，根据运行时错误逐步添加缺失的模块。
- 常见模块: 对于大多数Spring Boot应用，除了java.base和java.logging，java.desktop（用于java.beans）、java.xml、java.sql、java.naming等模块也常常是必需的。
- 模块化插件: 对于复杂的项目，可以考虑使用Maven或Gradle的模块化插件（如maven-jlink-plugin）来自动化模块依赖分析和运行时构建过程。
- 压缩选项: jlink还提供了--compress选项来进一步减小运行时镜像的大小，例如--compress=2可以进行中等程度的压缩。
- 彻底测试: 构建自定义运行时后，务必对应用程序进行彻底的功能测试，以确保所有必要的组件都已包含在内。
通过上述步骤，您可以为您的Spring Boot应用程序成功构建一个轻量级、定制化的Java运行时，从而实现更高效的部署和资源利用。
