Gradle多项目依赖报错：无法找到:ui项目匹配变体

项目结构 #

root
├── ui
├── track
├── settings.gradle
└── build.gradle

现有配置 #

根目录settings.gradle #

rootProject.name = 'root'
include 'track', 'ui'

track模块build.gradle（依赖配置） #

dependencies {
   // 其他依赖
   implementation project(':ui')
}

track模块settings.gradle #

rootProject.name = 'track'
    include 'ui'

ui模块settings.gradle #

rootProject.name = 'ui'

构建错误信息 #

Could not determine the dependencies of task ':compileJava'.
> Could not resolve all dependencies for configuration ':compileClasspath'.
   > Could not resolve project :ui.
     Required by:
         root project :
      > No matching variant of project :ui was found. The consumer was configured to find a library for use during compile-time, compatible with Java 17, packaged as a jar, preferably optimized for standard JVMs, and its dependencies declared externally but:
          - No variants exist.

问题分析与解决方案 #

核心问题 #

子模块track和ui各自存在独立的settings.gradle，破坏了Gradle多模块项目的结构逻辑。根目录的settings.gradle已经负责管理所有子模块，子模块单独的配置会导致Gradle无法正确识别模块间的依赖关系，进而找不到ui模块的可用构建变体。同时，ui模块作为资源提供方，需要确保其能生成可被其他模块引用的构件。

解决步骤 #

1. 删除子模块的settings.gradle文件
   移除root/track/settings.gradle和root/ui/settings.gradle，仅保留根目录的settings.gradle。

2. 调整ui模块的build.gradle配置
   根据ui模块是否需要独立运行，选择以下配置：

   • 场景1：ui模块无需独立运行（仅作为资源库）

     plugins {
         id 'java'
         id 'io.spring.dependency-management'
         // 若需Spring模板支持，保留Spring Boot BOM管理
         id 'org.springframework.boot' apply false
     }
     
     group = 'your.group.id'
     version = '0.0.1-SNAPSHOT'
     
     java {
         sourceCompatibility = JavaVersion.VERSION_17
     }
     
     repositories {
         mavenCentral()
     }
     
     dependencyManagement {
         imports {
             mavenBom org.springframework.boot.gradle.plugin.SpringBootPlugin.BOM_COORDINATES
         }
     }
     
     dependencies {
         // 添加模板相关依赖，例如Thymeleaf
         implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
         // 其他必要依赖
     }
     
     // 确保生成标准jar包供其他模块依赖
     jar {
         enabled = true
     }
     

   • 场景2：ui模块需要独立运行
     保留Spring Boot插件，同时启用标准jar打包：

     plugins {
         id 'org.springframework.boot'
         id 'io.spring.dependency-management'
         id 'java'
     }
     
     group = 'your.group.id'
     version = '0.0.1-SNAPSHOT'
     
     java {
         sourceCompatibility = JavaVersion.VERSION_17
     }
     
     repositories {
         mavenCentral()
     }
     
     dependencies {
         implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
         // 其他必要依赖
     }
     
     // 启用标准jar打包（供依赖使用）
     jar {
         enabled = true
     }
     
     // 将Spring Boot可执行jar标记为分类包，避免冲突
     bootJar {
         classifier = 'exec'
     }
     

3. 确认track模块依赖配置
   确保root/track/build.gradle中的依赖声明正确：

   dependencies {
       // 其他依赖
       implementation project(':ui')
   }
   

4. 重新构建
   在根目录执行构建命令：

   ./gradlew clean build
   

   或单独构建track模块：

   ./gradlew :track:build
   

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