本文旨在指导读者如何为基于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免费学习笔记（深入）”；
构建工具: MavenJava版本: Java 19Spring Boot版本: 3.0额外依赖: commons-lang3
pom.xml配置示例：
4.0.0 org.springframework.boot spring-boot-starter-parent 3.0.0 com.example demo 0.0.1-SNAPSHOT demo Demo project for Spring Boot 19 org.springframework.boot spring-boot-starter org.springframework.boot spring-boot-starter-test test org.apache.commons commons-lang3 org.springframework.boot spring-boot-maven-plugin
主应用类 DemoApplication.java 如下：
package com.example.demo;import org.apache.commons.lang3.StringUtils;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplicationpublic 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.basedemo-0.0.1-SNAPSHOT.jar -> java.loggingdemo-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应用时：
PHPCMS V9
PHPCMS V9（后面简称V9）采用PHP5+MYSQL做为技术基础进行开发。V9采用OOP（面向对象编程）+ MVC设计模式,进行基础运行框架搭建。模块化开发方式做为功能开发形式。框架易于功能扩展，代码维护，优秀的二次开发能力，可满足所有网站的应用需求。 5年开发经验的优秀团队，在掌握了丰富的WEB开发经验和CMS产品开发经验的同时，勇于创新追求完美的设计理念，为全球多达10万网站提供助力，并
296 查看详情 
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运行时，从而实现更高效的部署和资源利用。
以上就是Java模块化：为Spring Boot应用创建自定义运行时的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/899542.html
微信扫一扫 
支付宝扫一扫 
