IntelliJ中如何向模块化JavaFX项目添加含拆分包的非模块化JAR

问题背景 #

我用Mapsforge库做地图展示，JavaFX实现GUI。虽然能用javafx-maven-plugin以非模块化范式编译JavaFX，但不符合最佳实践。Mapsforge存在拆分包问题：org.mapsforge.map.rendertheme包同时存在于mapsforge.map和mapsforge.themes模块中，导致无法在module-info里同时声明依赖两者，报错：

java: java.lang.reflect.InvocationTargetException
Modules mapsforge.map and mapsforge.themes export package org.mapsforge.map.rendertheme to module org.postgresql.jdbc

查了同类问题后，尝试把库作为JAR添加到类路径而非模块依赖，但在IntelliJ中操作后仍无法引用JAR中的类，报错：

java: package org.mapsforge.core.graphics is not visible (package org.mapsforge.core.graphics is declared in the unnamed module, but module rfinder does not read it)

想知道怎么让包含外部JAR的无名模块对rfinder模块可见，优先用Maven方案，不知道如何把Maven包添加到类路径。

解决方案 #

1. 配置Maven插件，让模块读取无名模块 #

在项目的pom.xml中，通过maven-compiler-plugin和maven-surefire-plugin添加参数，强制rfinder模块读取所有类路径下的无名模块内容，同时保留Mapsforge的正常依赖引入：

<build>
    <plugins>
        <!-- 保留原有的JavaFX插件配置 -->
        <plugin>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-maven-plugin</artifactId>
            <!-- 你的JavaFX插件配置，比如模块、主类等 -->
        </plugin>

        <!-- 配置编译器插件，添加模块读取参数 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <release>17</release> <!-- 替换成你实际使用的JDK版本 -->
                <compilerArgs>
                    <arg>--add-reads</arg>
                    <arg>rfinder=ALL-UNNAMED</arg>
                </compilerArgs>
            </configuration>
        </plugin>

        <!-- 配置运行插件，添加同样的参数保证运行时生效 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.2.2</version>
            <configuration>
                <argLine>--add-reads rfinder=ALL-UNNAMED</argLine>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 清理module-info.java的无效依赖 #

把module-info.java中原本声明的requires mapsforge.map;和requires mapsforge.themes;语句删掉，因为现在这些库在类路径的无名模块中，不需要在模块描述里声明依赖。

3. 同步IntelliJ配置并重构项目 #

• 点击IntelliJ右侧Maven面板的刷新按钮，让IDE加载新的Maven配置。
• 打开File → Project Structure → Modules → rfinder模块 → Dependencies标签，确认Mapsforge相关JAR的作用域是Classpath而非Modulepath。
• 执行Build → Clean Project，再执行Build → Rebuild Project，清理旧编译文件并重新构建。

原理说明 #

--add-reads rfinder=ALL-UNNAMED参数的作用是让你的rfinder模块明确读取所有类路径下的无名模块内容，直接解决了“包在无名模块中但当前模块未读取”的报错。而将Mapsforge依赖留在类路径下，就避开了它的拆分包导致的模块化冲突问题，同时保留了项目的模块化结构，符合最佳实践。

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