Java模块化：为Spring Boot应用创建自定义运行时-java教程-PHP中文网

Java模块化：为Spring Boot应用创建自定义运行时

花韻仙語

发布： 2025-11-10 13:45:47

原创

627人浏览过

java模块化：为spring boot应用创建自定义运行时

本文旨在指导读者如何为基于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应用时：

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

查看详情

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可以进行中等程度的压缩。
彻底测试: 构建自定义运行时后，务必对应用程序进行彻底的功能测试，以确保所有必要的组件都已包含在内。