Gradle项目导入SwingFXUtils失败的问题求助

1. 正确配置Gradle引入JavaFX Swing模块 #

JavaFX 11+采用模块化设计，仅手动添加implementation依赖可能无法正确配置模块路径，推荐使用官方Gradle插件或规范配置依赖：

方式一：使用JavaFX Gradle插件（推荐） #

在build.gradle中先应用插件并指定模块：

plugins {
    id 'application'
    id 'org.openjfx.javafxplugin' version '0.0.13' // 版本可根据Gradle/Java版本调整
}

javafx {
    version = '11.0.2' // 替换为正式稳定版，避免使用EA测试版
    modules = ['javafx.embed.swing', 'javafx.controls'] // 按需添加其他需要的JavaFX模块
}

插件会自动处理依赖下载、模块路径配置，无需手动设置JVM参数。

方式二：手动配置依赖与模块路径 #

若不想使用插件，需确保依赖版本统一，并配置运行时模块参数：

dependencies {
    implementation 'org.openjfx:javafx-swing:11.0.2'
    implementation 'org.openjfx:javafx-controls:11.0.2'
    implementation 'org.openjfx:javafx-base:11.0.2'
}

run {
    jvmArgs = ['--module-path', classpath.asPath, '--add-modules', 'javafx.embed.swing,javafx.controls']
}

2. 修正module-info.java配置 #

确保模块声明中正确引入依赖，替换为你的实际模块名：

module your.project.module.name {
    requires javafx.embed.swing;
    requires javafx.controls; // 若用到其他JavaFX模块需一并声明
}

3. 清理缓存并重新构建 #

• 执行Gradle的clean任务清除旧构建缓存
• 执行compileJava或build任务重新编译代码
• 重启IDE（如IntelliJ IDEA），避免IDE缓存导致的依赖识别异常

4. 排查常见问题 #

• 避免使用JavaFX的EA测试版本（如你之前用的11-ea+24），改用正式稳定版
• 确保项目Java版本与JavaFX版本兼容（JavaFX 11需Java 11及以上）
• 若手动放置jar到libs目录，需在Gradle中正确引入该目录：

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
}

但此方式易出现版本不匹配问题，优先推荐仓库依赖。

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