JavaFX+iText7 Maven项目模块报错及桌面Jar运行问题求助

我是开发新手，正在VSCode中搭建JavaFX与iText7的Maven项目，对Maven依赖的使用不太理解。已在pom.xml中配置了iText7各组件的依赖：

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>kernel</artifactId>
    <version>${itext.version}</version>
</dependency>
<!-- always needed -->
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>io</artifactId>
    <version>${itext.version}</version>
</dependency>
<!-- always needed -->
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>layout</artifactId>
    <version>${itext.version}</version>
</dependency>
<!-- only needed for forms -->
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>forms</artifactId>
    <version>${itext.version}</version>
</dependency>
<!-- only needed for PDF/A -->
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>pdfa</artifactId>
    <version>${itext.version}</version>
</dependency>
<!-- only needed for digital signatures -->
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>sign</artifactId>
    <version>${itext.version}</version>
</dependency>
<!-- only needed for barcodes -->
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>barcodes</artifactId>
    <version>${itext.version}</version>
</dependency>

在module-info.java中使用以下代码声明依赖：

requires transitive kernel;
requires transitive io;
requires transitive forms;
requires transitive layout;
requires transitive barcodes;
requires transitive pdfa;
requires transitive sign;

但每一行都出现错误：Name of automatic module 'kernel' is unstable, it is derived from the module's file name（对应io、forms等模块的同类错误）。生成的Jar文件在终端可运行，但双击桌面图标无法启动，且终端运行时出现警告：WARNING: Unsupported JavaFX configuration: classes were loaded from 'unnamed module @5a65309b'。

1. 解决iText7自动模块名称不稳定的错误 #

iText7的Jar包已支持Java模块化，但你使用的是自动生成的模块名（如kernel），这类名称不稳定。需替换为iText官方声明的标准模块名，修改module-info.java如下：

module 你的模块名 { // 替换成你自己的模块名，比如com.myjavafxapp
    // JavaFX模块依赖（根据你的项目需求调整）
    requires javafx.controls;
    requires javafx.fxml;

    // iText7标准模块依赖
    requires transitive com.itextpdf.kernel;
    requires transitive com.itextpdf.io;
    requires transitive com.itextpdf.layout;
    requires transitive com.itextpdf.forms;
    requires transitive com.itextpdf.pdfa;
    requires transitive com.itextpdf.sign;
    requires transitive com.itextpdf.barcodes;

    // 导出主类所在包，让JavaFX能访问
    exports 你的主类所在包; // 比如com.myjavafxapp
}

2. 解决JavaFX未模块化的警告 #

警告说明JavaFX类从无名模块加载，需通过Maven插件正确处理JavaFX模块化依赖。在pom.xml的<build>标签下添加以下插件配置：

<plugins>
    <!-- JavaFX打包插件 -->
    <plugin>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-maven-plugin</artifactId>
        <version>0.0.8</version>
        <configuration>
            <!-- 替换为你的模块名/主类全限定名，例如com.myjavafxapp/com.myjavafxapp.Main -->
            <mainClass>你的模块名/你的主类全类名</mainClass>
        </configuration>
        <executions>
            <execution>
                <id>bundle</id>
                <phase>package</phase>
                <goals>
                    <goal>jlink</goal>
                </goals>
            </execution>
        </executions>
    </plugin>
    <!-- 编译插件，指定Java版本 -->
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.11.0</version>
        <configuration>
            <release>17</release> <!-- 替换为你使用的Java版本，如11/17 -->
        </configuration>
    </plugin>
</plugins>

3. 解决Jar双击无法启动的问题 #

直接打包的普通Jar无法处理JavaFX的模块化依赖，使用上述javafx-maven-plugin的jlink目标生成自包含运行时镜像：

• 在VSCode终端执行命令：mvn clean package
• 打包完成后，项目目录下的target/image文件夹会生成对应平台的运行环境（Windows为exe启动器，Mac为.app包，Linux为可执行文件）
• 直接双击对应平台的启动文件即可运行，无需用户单独安装Java或JavaFX环境

如果需要生成可执行Jar（不推荐，依赖系统Java环境），可以修改javafx-maven-plugin的配置，添加jar目标：

<execution>
    <id>create-jar</id>
    <phase>package</phase>
    <goals>
        <goal>jar</goal>
    </goals>
</execution>

生成的可执行Jar需要确保系统已安装对应版本的JavaFX运行时，或通过命令行指定模块路径启动。

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