JavaFX自定义组件库导入运行时模块解析异常求助

问题根源 #

这个异常是Java模块系统的包冲突导致的：你的自定义库模块com.example.My_Library中意外包含了JavaFX官方模块（javafx.controls）已经提供的包（比如javafx.scene.control.cell、javafx.scene.chart），Java不允许两个模块拥有同名的包，因此启动时触发了ModuleResolutionException。

解决步骤 #

1. 排查并清理项目中的非法包 #

• 检查你的库项目源码目录，确认是否手动创建了javafx.scene.control.cell、javafx.scene.chart、javafx.scene.control这类包，直接删除这些包——它们是JavaFX SDK自带的系统包，不需要在你的自定义库中存在。
• 检查项目编译输出目录（比如target/classes或build/classes），如果里面有这些JavaFX系统包的class文件，执行项目清理操作（比如Maven的mvn clean、Gradle的gradle clean）删除这些文件。

2. 修正构建配置，避免打包JavaFX依赖 #

你的自定义库只需要依赖JavaFX API，不需要把JavaFX的类打包到自己的jar中（使用你库的应用会自行引入JavaFX运行时）：

• Maven示例：确保pom.xml中JavaFX依赖仅为编译时依赖，打包时不包含：

<dependencies>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>你的JavaFX版本</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-fxml</artifactId>
        <version>你的JavaFX版本</version>
        <scope>compile</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.3.0</version>
            <configuration>
                <archive>
                    <manifestEntries>
                        <Automatic-Module-Name>com.example.My_Library</Automatic-Module-Name>
                    </manifestEntries>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>

• Gradle示例：将JavaFX依赖设为implementation，打包时排除依赖：

plugins {
    id 'java-library'
    id 'org.openjfx.javafxplugin' version '0.0.13'
}

javafx {
    version = "你的JavaFX版本"
    modules = ['javafx.controls', 'javafx.fxml']
}

dependencies {
    implementation 'org.openjfx:javafx-controls:你的JavaFX版本'
    implementation 'org.openjfx:javafx-fxml:你的JavaFX版本'
}

jar {
    manifest {
        attributes('Automatic-Module-Name': 'com.example.My_Library')
    }
}

3. 验证修复结果 #

• 清理并重新编译打包你的自定义库。
• 将新打包的jar导入到应用项目中，确保应用项目也正确配置了JavaFX依赖，再运行应用即可解决异常。

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