JavaFX Maven项目执行mvn javafx:run启动失败求助

问题分析 #

你在Windows 10下使用Java 19+JavaFX 19，执行mvn javafx:run时遇到的Error initializing QuantumRenderer: no suitable pipeline found错误，核心原因是JavaFX图形渲染依赖未正确加载，结合你的pom.xml来看，存在几个明显的配置问题：

1. JavaFX依赖重复定义，可能导致依赖冲突
2. Maven编译插件的release版本与实际使用的Java版本不匹配
3. 老旧的javafx-maven-plugin版本可能存在兼容性问题
4. 同时引入多平台的javafx-graphics依赖，可能导致加载混乱

解决方案 #

步骤1：修正pom.xml配置 #

替换原pom.xml中的<build>和<dependencies>部分为以下内容：

<build>
    <sourceDirectory>src</sourceDirectory>
    <plugins>
        <!-- 升级到最新稳定版的javafx-maven-plugin -->
        <plugin>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-maven-plugin</artifactId>
            <version>0.0.10</version>
            <configuration>
                <mainClass>main.FX</mainClass>
                <!-- 指定运行平台，Windows下无需手动引入带classifier的依赖 -->
                <platforms>
                    <platform>win</platform>
                </platforms>
            </configuration>
        </plugin>

        <!-- 编译版本与Java 19匹配 -->
        <plugin>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <release>19</release>
            </configuration>
        </plugin>
    </plugins>
</build>
<dependencies>
    <!-- 保留你的其他业务依赖 -->
    <dependency>
        <groupId>org.bouncycastle</groupId>
        <artifactId>bcpkix-jdk15on</artifactId>
        <version>1.56</version>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>com.owlike</groupId>
        <artifactId>genson</artifactId>
        <version>1.4</version>
    </dependency>
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>
    <dependency>
        <groupId>org.glassfish.jersey.inject</groupId>
        <artifactId>jersey-hk2</artifactId>
        <version>2.27</version>
    </dependency>
    <dependency>
        <groupId>org.glassfish.jersey.containers</groupId>
        <artifactId>jersey-container-servlet</artifactId>
        <version>2.27</version>
    </dependency>
    <dependency>
        <groupId>org.apache.tomcat.embed</groupId>
        <artifactId>tomcat-embed-core</artifactId>
        <version>8.5.11</version>
    </dependency>
    <dependency>
        <groupId>org.apache.tomcat</groupId>
        <artifactId>tomcat-jasper</artifactId>
        <version>8.0.43</version>
    </dependency>
    <dependency>
        <groupId>javax.xml.bind</groupId>
        <artifactId>jaxb-api</artifactId>
        <version>2.3.1</version>
    </dependency>
    <dependency>
        <groupId>org.jgroups</groupId>
        <artifactId>jgroups</artifactId>
        <version>4.0.0.Final</version>
    </dependency>
    <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-csv</artifactId>
        <version>1.4</version>
    </dependency>

    <!-- 简化JavaFX依赖，由插件自动处理平台特定依赖 -->
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>19</version>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-graphics</artifactId>
        <version>19</version>
        <scope>runtime</scope>
    </dependency>
</dependencies>

步骤2：清理并重新构建项目 #

执行以下命令清理旧的依赖和构建文件：

mvn clean

然后重新运行项目：

mvn javafx:run

额外排查点 #

如果上述步骤仍未解决问题，检查以下内容：

• 确认JAVA_HOME环境变量指向Java 19 JDK（而非JRE）
• 移除项目根目录下的.m2缓存文件夹（路径一般为C:\Users\<你的用户名>\.m2\repository\org\openjfx），重新拉取依赖
• 确保没有其他第三方依赖与JavaFX的图形渲染库冲突

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