JavaFX 17版本下Maven构建自定义类库出现包不存在错误如何解决

该报错与JDK-8264998相关，是Java 17+版本中，旧版maven-compiler-plugin的兼容bug导致：当项目使用模块化依赖时，空模块路径下自动添加--add-modules ALL-MODULE-PATH的逻辑失效，编译器无法识别JavaFX的模块包。

按优先级依次尝试以下操作：

• 优先升级maven-compiler-plugin到3.8.1及以上版本（推荐使用3.11.0+稳定版），插件高版本已修复该兼容问题，参考配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <source>17</source>
        <target>17</target>
        <release>17</release>
    </configuration>
</plugin>

• 若升级插件后仍存在报错，可手动在编译参数中显式声明需要引入的JavaFX模块，参考配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <source>17</source>
        <target>17</target>
        <release>17</release>
        <compilerArgs>
            <arg>--add-modules</arg>
            <arg>javafx.controls,javafx.graphics,javafx.base,javafx.fxml</arg>
        </compilerArgs>
    </configuration>
</plugin>

可根据项目实际用到的JavaFX模块增减上述列表中的模块名。

• 检查pom中JavaFX依赖的scope配置，自用类库项目不要将JavaFX依赖的scope设为runtime，需保持默认的compile scope，确保编译期可以读取到JavaFX的类包。
• 确认所有需要的JavaFX模块依赖都已完整引入，不要遗漏javafx-base、javafx-controls、javafx-graphics等核心模块。

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