Maven 3.8.1编译JavaFX 17项目提示相关包不存在问题咨询

问题根因 #

你遇到的报错是JavaFX 17和旧版maven-compiler-plugin的模块路径推断逻辑不兼容导致的：

• JavaFX 17开始所有官方构件都被标记为纯JPMS模块化构件，不再兼容传统的自动模块类路径加载逻辑
• 你使用的maven-compiler-plugin:3.8.1存在路径推断缺陷：如果项目没有编写module-info.java声明为模块化项目，遇到纯模块化依赖时只会将依赖放到模块路径，不会同步加入类路径，导致非模块化项目编译时找不到JavaFX相关包
• JavaFX 16的构件同时支持模块化和非模块化加载，旧版插件会自动将其同时放到类路径和模块路径，所以降级到16可以正常编译
• IDE能正常运行是因为Eclipse、IntelliJ的内置构建逻辑会独立处理JavaFX依赖的路径配置，不受Maven插件的推断逻辑限制

解决方法 #

你可以任选以下一种方案解决：

方案1：升级maven-compiler-plugin到3.10.1及以上版本（推荐） #

新版本Maven编译插件已经修复了模块化依赖的路径推断问题，非模块化项目会自动把纯模块化依赖同步加入类路径，不需要修改其他配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <source>${java.version}</source>
        <target>${java.version}</target>
    </configuration>
</plugin>

修改后执行mvn clean compile即可正常编译。

方案2：显式指定依赖加载到类路径 #

如果不方便升级插件，可以在编译插件的配置中增加编译参数，强制将依赖加入类路径：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <configuration>
        <source>${java.version}</source>
        <target>${java.version}</target>
        <compilerArgs>
            <arg>--class-path</arg>
            <arg>${maven.dependency.classpath}</arg>
        </compilerArgs>
    </configuration>
</plugin>

方案3：将项目改为模块化项目 #

在项目的src/main/java目录下新增module-info.java文件，显式声明需要引入的JavaFX模块：

module btx.prog.one.hellomvn {
    requires javafx.controls;
    requires javafx.fxml;
    requires javafx.graphics;

    exports btx.prog.one.hellomvn;
}

内容的提问来源于stack exchange，提问作者Eric D.