Maven构建JavaFX应用报错：找不到主类及NoClassDefFoundError

问题根源 #

你遇到的报错包含两个关键问题：

• 主类路径不匹配：报错中提到的Game.GUI.Start与你实际代码的包Snake.GUI.Start不一致，说明运行时指定的主类有误
• JavaFX运行时依赖缺失：从JDK 11开始JavaFX被移出标准JDK，仅通过Maven依赖无法在运行时加载JavaFX类，导致NoClassDefFoundError

分步解决方案 #

1. 统一主类引用 #

确保所有运行配置中的主类路径为Snake.GUI.Start：

• 检查IDE的运行配置，确认主类选择的是Snake.GUI.Start
• 你的POM中maven-jar-plugin的mainClass配置已正确，无需修改，但要避免手动运行时输入错误的主类名

2. 添加JavaFX Maven插件 #

替换POM中的构建插件配置，使用官方javafx-maven-plugin处理JavaFX的模块路径和运行环境：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version> <!-- 适配JDK19的最新兼容版本 -->
            <configuration>
                <source>19</source>
                <target>19</target>
            </configuration>
        </plugin>
        <!-- JavaFX官方插件，处理运行与打包 -->
        <plugin>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-maven-plugin</artifactId>
            <version>0.0.8</version>
            <configuration>
                <mainClass>Snake.GUI.Start</mainClass>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.3.0</version>
            <configuration>
                <archive>
                    <manifest>
                        <addClasspath>true</addClasspath>
                        <mainClass>Snake.GUI.Start</mainClass>
                    </manifest>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>

3. 正确运行应用 #

• 使用Maven命令启动：mvn javafx:run，该命令会自动配置JavaFX模块路径，避免运行时依赖缺失
• 若需打包成独立可执行程序，执行mvn javafx:jlink，生成的包会包含JRE和JavaFX依赖，可直接在无JDK环境运行

4. 模块系统配置（可选） #

如果你的项目使用module-info.java，需确保模块声明包含JavaFX依赖：

module Snake.GUI {
    requires javafx.controls;
    requires javafx.fxml;
    exports Snake.GUI;
    opens Snake.GUI.controller to javafx.fxml;
}

验证流程 #

1. 执行mvn clean compile清理编译，确保无编译错误
2. 执行mvn javafx:run启动应用，检查是否正常运行

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