Gradle JavaFX Jlink打包报错：应用模块路径存在重复模块

• 检查JavaFX依赖的平台配置
  跨Linux和Windows打包时，最常见的原因是同时引入了多平台的JavaFX模块JAR（比如linux和win版本的javafx.base）。

  • 确认build.gradle中JavaFX依赖是否通过classifier或插件的platforms属性做了平台区分，避免重复拉取：

    javafx {
        version = '21'
        modules = ['javafx.controls', 'javafx.fxml']
        platforms = ['linux', 'win']
    }
    

  • 排查是否同时用了JavaFX插件和手动添加implementation依赖，导致模块重复引入。

• 校验badass-jlink-plugin配置

  • 检查jlink块中是否手动添加了已被Gradle自动处理的模块路径，或重复指定了JavaFX模块。
  • 暂时关闭mergeServiceProviders等可能引发模块冲突的配置项，测试是否能正常打包。

• 清理依赖缓存并同步
  执行gradle clean build --refresh-dependencies清理本地缓存，重新拉取依赖。同时检查WSL下~/.gradle/caches/modules-2/files-2.1/org.openjfx目录，确认是否存在不同平台的重复JavaFX模块JAR。

• 检查module-info.java声明
  确保模块描述文件中没有重复声明JavaFX模块依赖，比如：

  module your.app.module {
      requires javafx.base;
      requires javafx.controls;
      // 避免重复的requires语句
  }
  

  同时排查是否有第三方依赖间接引入了不同版本的JavaFX模块，引发版本冲突。

• 跨平台打包的WSL环境特殊处理
  分平台单独打包，避免多平台依赖同时存在于模块路径：

  • 打包Linux版本：gradle jlink -Pjavafx.platform=linux
  • 打包Windows版本：gradle jlink -Pjavafx.platform=win
    也可在build.gradle中通过条件判断加载对应平台的依赖，隔离多平台JAR。

• 通过详细日志定位重复来源
  执行gradle jlink --info查看完整日志，找到报错中重复模块的具体文件路径（比如两个不同平台的javafx-base.jar），再针对性调整依赖配置，排除冗余的模块JAR。

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