Eclipse中Maven无法引入16以上版本JavaFX依赖求助

问题背景 #

我正在把现有JavaFX项目转成Maven项目，用的是Java 17和Eclipse 4.32.0。发现只要添加版本高于16的JavaFX依赖（比如javafx-controls:21.0.1、javafx-fxml:22.0.1）就会报错，版本16及以下没问题。之前从没接触过Maven，不知道怎么排查。

补充的完整pom.xml如下：

<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>GameClientGUI</groupId>
    <artifactId>GameClientGUI</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <dependencies>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-controls</artifactId>
            <version>16</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.openjfx/javafx-fxml -->
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-fxml</artifactId>
            <version>17</version>
        </dependency>

    </dependencies>
    <build>
        <sourceDirectory>src</sourceDirectory>
        <resources>
            <resource>
                <directory>src</directory>
                <excludes>
                    <exclude>**/*.java</exclude>
                </excludes>
            </resource>
        </resources>
        <plugins>
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <release>17</release>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.openjfx</groupId>
                <artifactId>javafx-maven-plugin</artifactId>
                <version>0.0.8</version>
                <configuration>
                    <mainClass>HelloFX</mainClass>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

解决步骤 #

• 统一JavaFX依赖版本：不要混用不同大版本的JavaFX依赖（比如当前pom里16和17混着用），Java 17建议搭配JavaFX 17.x版本，保证兼容性。
• 添加平台分类器：JavaFX从17版本开始，核心依赖分平台（Windows、Mac、Linux），需要在依赖里指定对应系统的分类器。用Maven配置文件（profiles）可以自动适配当前系统。
• 更新插件版本：你用的javafx-maven-plugin 0.0.8版本太老，不支持高版本JavaFX，建议更新到最新稳定版（比如0.0.15）；同时把maven-compiler-plugin也更新到适配Java17的版本（比如3.11.0）。
• 清理Maven缓存：如果Eclipse里还是报错，右键项目 → Maven → Clean，再执行Maven → Update Project，强制拉取正确的依赖。

修改后的pom.xml示例 #

<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>GameClientGUI</groupId>
    <artifactId>GameClientGUI</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <!-- 统一JavaFX版本，自动适配平台 -->
    <properties>
        <javafx.version>17.0.11</javafx.version>
    </properties>

    <profiles>
        <profile>
            <id>windows</id>
            <activation>
                <os><family>Windows</family></os>
            </activation>
            <properties>
                <javafx.classifier>win</javafx.classifier>
            </properties>
        </profile>
        <profile>
            <id>mac</id>
            <activation>
                <os><family>Mac</family></os>
            </activation>
            <properties>
                <javafx.classifier>mac</javafx.classifier>
            </properties>
        </profile>
        <profile>
            <id>linux</id>
            <activation>
                <os><family>Linux</family></os>
            </activation>
            <properties>
                <javafx.classifier>linux</javafx.classifier>
            </properties>
        </profile>
    </profiles>

    <dependencies>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-controls</artifactId>
            <version>${javafx.version}</version>
            <classifier>${javafx.classifier}</classifier>
        </dependency>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-fxml</artifactId>
            <version>${javafx.version}</version>
            <classifier>${javafx.classifier}</classifier>
        </dependency>
    </dependencies>

    <build>
        <sourceDirectory>src</sourceDirectory>
        <resources>
            <resource>
                <directory>src</directory>
                <excludes>
                    <exclude>**/*.java</exclude>
                </excludes>
            </resource>
        </resources>
        <plugins>
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.11.0</version>
                <configuration>
                    <release>17</release>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.openjfx</groupId>
                <artifactId>javafx-maven-plugin</artifactId>
                <version>0.0.15</version>
                <configuration>
                    <mainClass>HelloFX</mainClass>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

额外说明 #

• 如果你的项目是模块化的（有module-info.java），确保模块声明里正确引入JavaFX依赖，比如：

  module GameClientGUI {
      requires javafx.controls;
      requires javafx.fxml;
      opens your.package.name to javafx.fxml;
      exports your.package.name;
  }
  

• 启动项目时用mvn javafx:run命令，不要用普通的mvn run，这样插件会正确处理模块和依赖加载。

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