IntelliJ中JavaFX模块依赖Java Gradle模块失败问题

使用IntelliJ IDEA Community Edition 2024.1.4，创建基于Gradle和Java 21的多模块项目，根目录settings.gradle配置如下：

rootProject.name = 'demo'
include 'the-library'
include 'core'
include 'ui'

项目包含三个模块：the-library、core、ui，其中core依赖the-library可正常构建。

通过IntelliJ向导创建JavaFX类型的ui模块后，在其build.gradle中添加core依赖，Gradle同步时报错：

FAILURE: Build failed with an exception.

* Where:
Build file 'D:\dev\demo\ui\build.gradle' line: 43

* What went wrong:
A problem occurred evaluating root project 'ui'.
> Project with path ':core' could not be found in root project 'ui'.

已尝试重建模块、项目及更换IntelliJ版本，问题未解决。

1. 确认模块层级关系 #

打开IntelliJ的File > Project Structure > Modules，检查ui模块的父项目是否为根项目demo：

• 如果ui的父项目不是demo，点击Set Parent选择demo，确保ui作为子模块存在于根项目上下文中。

2. 修正ui/build.gradle的依赖声明 #

确保依赖配置中正确引用core模块，避免错误的项目上下文：

dependencies {
    // 保留原有JavaFX相关依赖，比如：
    implementation 'org.openjfx:javafx-controls:21.0.2'
    implementation 'org.openjfx:javafx-fxml:21.0.2'
    
    // 添加core模块依赖
    implementation project(':core')
}

检查脚本中是否存在误将ui作为根项目的代码（比如错误的rootProject调用），如有则删除。

3. 验证根目录settings.gradle的位置 #

确保settings.gradle仅存在于根目录D:\dev\demo下，不要在ui模块目录中存放该文件，否则Gradle会将ui识别为独立根项目，无法找到:core。

4. 强制刷新Gradle配置 #

• 在IntelliJ的Gradle工具窗口点击「Refresh all Gradle projects」按钮；
• 或在根目录执行命令：

  # Windows
  gradlew.bat clean build --refresh-dependencies
  
  # Linux/Mac
  ./gradlew clean build --refresh-dependencies
  

5. JPMS模块适配（若启用模块化） #

如果项目使用Java模块系统，在ui模块的module-info.java中添加对core模块的依赖声明：

module ui {
    requires core;
    requires javafx.controls;
    requires javafx.fxml;
    // 其他必要的requires声明
}

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