Gradle配置本地JavaFX SDK后启动报错，如何解决？

问题原因 #

你的build.gradle仅将JavaFX的JAR包作为普通依赖导入，但JavaFX是模块化框架，JVM需要明确知道模块路径和要加载的模块，直接导入JAR的方式无法让运行时识别JavaFX组件。

解决方案 #

方案1：使用官方JavaFX Gradle插件（推荐） #

该插件会自动处理模块路径、依赖和运行参数，配置更简洁可靠：

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

repositories {
    mavenCentral()
}

mainClassName = 'ru.danteproject.App'

javafx {
    version = '17.0.7'
    // 指定本地JavaFX SDK路径，若不填则自动从Maven下载对应版本
    sdk = 'C:\\Program Files\\openjfx-17.0.7_windows-x64_bin-sdk\\javafx-sdk-17.0.7'
    // 声明需要的JavaFX模块，根据代码需求添加
    modules = ['javafx.controls', 'javafx.fxml']
}

方案2：手动配置JVM运行参数 #

如果不想使用插件，需在application块中添加JVM参数，明确指定模块路径和要加载的模块：

plugins {
    id 'java'
    id 'application'
}

repositories {
    mavenCentral()
    flatDir {
        dirs 'C:\\Program Files\\openjfx-17.0.7_windows-x64_bin-sdk\\javafx-sdk-17.0.7\\lib'
    }
}

mainClassName = 'ru.danteproject.App'

dependencies {
    implementation fileTree(dir: 'C:\\Program Files\\openjfx-17.0.7_windows-x64_bin-sdk\\javafx-sdk-17.0.7\\lib', include: '*.jar')
}

application {
    jvmArgs = [
        '--module-path', 'C:\\Program Files\\openjfx-17.0.7_windows-x64_bin-sdk\\javafx-sdk-17.0.7\\lib',
        '--add-modules', 'javafx.controls,javafx.fxml'
    ]
}

额外注意事项 #

• 确保hello-view.fxml文件放置在src/main/resources/ru/danteproject/目录下，这样App.class.getResource("hello-view.fxml")才能正确加载文件。
• 若使用IDE（如IntelliJ IDEA）直接运行，需在运行配置的VM选项中手动添加以下参数：

  --module-path "C:\Program Files\openjfx-17.0.7_windows-x64_bin-sdk\javafx-sdk-17.0.7\lib" --add-modules javafx.controls,javafx.fxml
  

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