为什么Gradle无法正确运行JavaFX应用？多场景报错及配置问题求助

核心问题根因 #

现有配置混合了手动模块路径设置、本地Jar依赖声明，和Gradle的模块化默认逻辑、IDEA的依赖同步规则冲突，三个问题都可以通过规范Gradle配置解决。

第一步：修正配置文件 #

1. 修改build.gradle #

删除原有手动配置的compileJava、run任务自定义逻辑，改用官方JavaFX插件管理依赖，完整配置如下：

plugins {
  id 'application'
  id 'org.openjfx.javafxplugin' version '0.1.0'
}

repositories {
    mavenCentral()
}

// JavaFX插件自动管理SDK依赖、模块路径
javafx {
    version = "17.0.1"
    modules = [ 'javafx.controls', 'javafx.base' ]
}

dependencies{
  // 引入gson依赖，无需额外配置
  implementation 'com.google.code.gson:gson:2.8.9'
}

application {
  mainModule = 'piglet.friend'
  mainClass = 'piglet.friend.Main'
}

java {
    sourceCompatibility = '17'
    targetCompatibility = '17'
    modularity.inferModulePath = true
}

jar {
    manifest {
      attributes 'Main-Class': 'piglet.friend.Main'
    }
}

2. 修正module-info.java #

报错提示找不到piglet包，是因为你声明了打开不存在的包，修改为实际存在的包路径即可：

module piglet.friend{
   requires javafx.controls;
   requires com.google.gson;
   // 改为你实际存在的包，需要反射的包都要opens
   opens piglet.friend to com.google.gson, javafx.graphics;
   exports piglet.friend;
}

对应问题解决说明 #

问题1：Gradle run任务运行报错 #

• 原配置手动给run任务加了重复的--module-path参数，还将构建后的Jar放入模块路径，和Gradle默认用编译后的class目录运行的逻辑冲突，删除手动配置的run、compileJava自定义逻辑后，JavaFX插件会自动生成正确的运行参数，不会再出现模块读取错误。
• 修正module-info.java里的opens语句后，不存在包的报错会直接消失。

问题2：IDEA刷新Gradle后JavaFX依赖消失 #

• 原配置没有通过Gradle声明JavaFX依赖，IDEA的Gradle同步默认会覆盖手动添加的库，改用JavaFX插件声明依赖后，IDEA同步时会自动识别JavaFX依赖，不需要手动添加，刷新后也不会消失，代码不会爆红。
• 确认IDEA的Gradle设置中「构建和运行使用」选择Gradle即可。

问题3：引入gson后打包报错模块找不到 #

• 原配置中compileJava任务手动清空了classpath，且手动声明的模块路径只包含本地JavaFX目录，没有包含从Maven拉取的gson依赖路径，导致模块系统找不到gson。用上述配置后Gradle会自动将所有依赖加入模块路径，不需要手动配置，可正常编译打包。

可选：坚持使用本地JavaFX SDK的配置方案 #

如果不想使用官方插件，必须用本地SDK的话，修改build.gradle如下即可，不需要其他调整：

plugins {
  id 'application'
}

repositories {
    mavenCentral()
}

dependencies{
  // 一次性引入SDK下所有Jar，Gradle自动识别为模块
  implementation fileTree(dir: 'C:/Users/insec/Desktop/javafx-sdk-17.0.1/lib', include: '*.jar')
  implementation 'com.google.code.gson:gson:2.8.9'
}

application {
  mainModule = 'piglet.friend'
  mainClass = 'piglet.friend.Main'
}

java {
    sourceCompatibility = '17'
    targetCompatibility = '17'
    modularity.inferModulePath = true
}

jar {
    manifest {
      attributes 'Main-Class': 'piglet.friend.Main'
    }
}

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