克隆GitHub的Java项目启动报错：Module java.fxml not found 如何解决？

这个错误的核心原因是：JavaFX从JDK 11起不再捆绑在标准JDK中，你的项目依赖java.fxml模块，但运行环境未包含该模块，以下是不同场景的解决方法：

一、Maven管理的项目 #

在pom.xml中补充JavaFX依赖与运行插件：

1. 添加依赖

<dependencies>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>21.0.1</version> <!-- 版本请匹配项目实际需求 -->
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-fxml</artifactId>
        <version>21.0.1</version>
    </dependency>
</dependencies>

2. 添加运行插件

<build>
    <plugins>
        <plugin>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-maven-plugin</artifactId>
            <version>0.0.8</version>
            <configuration>
                <mainClass>你的主类全路径（如com.example.Main）</mainClass>
            </configuration>
        </plugin>
    </plugins>
</build>

之后用mvn javafx:run命令启动项目，而非普通的mvn exec:java。

二、Gradle管理的项目 #

在build.gradle中配置JavaFX插件与模块：

plugins {
    id 'java'
    id 'org.openjfx.javafxplugin' version '0.0.13'
}

javafx {
    version = '21.0.1'
    modules = ['javafx.controls', 'javafx.fxml']
}

mainClassName = '你的主类全路径'

执行gradle run命令启动项目即可。

三、无构建工具的手动配置 #

1. 下载对应系统与JDK版本的JavaFX SDK，解压到本地目录。
2. 命令行启动时，指定模块路径与所需模块：

java --module-path /本地/javafx-sdk/lib目录路径 --add-modules javafx.controls,javafx.fxml -jar 你的项目jar包.jar

3. IDE中配置（以IntelliJ为例）：

• 打开File → Project Structure，在Libraries中添加JavaFX SDK的lib目录；
• 进入Run/Debug Configurations，在VM options中填入：--module-path /本地/javafx-sdk/lib目录路径 --add-modules javafx.controls,javafx.fxml。

四、检查模块化声明文件 #

如果项目使用Java模块化，确保module-info.java中声明了对JavaFX模块的依赖：

module 你的模块名 {
    requires javafx.controls;
    requires javafx.fxml;
    // 若主类需要被框架访问，添加exports语句
    exports com.example to javafx.graphics;
}

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