Gradle多模块项目创建报错：找不到':base-project'路径原因排查

这个报错的核心问题是你错误地尝试让子模块依赖根项目本身，Gradle多模块结构的规则里，根项目和子模块的定位完全不同：

1. Gradle项目路径的规则限制

   • 根项目的rootProject.name = 'base-project'只是定义了根项目的名称，但根项目本身不存在:base-project这个可引用的项目路径。只有通过include声明的子模块（比如你的testng-module、junit-module）才有对应的:xxx-module路径。你在junit模块里写implementation project(':base-project')，Gradle会去寻找名为base-project的子模块，但你的settings.gradle里根本没include这个子模块，自然会报错找不到。

2. 根项目的定位是“父容器”而非“可依赖子项目”

   • 根项目的作用是作为所有子模块的父容器，用来统一配置所有子模块的公共规则（比如仓库地址、通用插件、全局依赖），它本身不是一个可以被子模块直接依赖的“子项目”，不存在可被依赖的编译产物。

如果想实现子模块复用公共逻辑或依赖，有两种靠谱的做法：

方式1：把公共代码抽成独立子模块 #

• 新建一个子模块（比如叫core-module），把原本想放在根项目里的公共工具类、通用逻辑都放到这个模块里
• 在根项目的settings.gradle里添加include 'core-module'
• 然后在junit-module和testng-module的build.gradle里改为依赖这个子模块：

  dependencies {
      implementation project(':core-module')
      // 各自的专属依赖...
  }
  

方式2：通过根项目统一配置子模块的通用依赖 #

如果只是想统一管理所有子模块的通用依赖（不需要共享代码），可以在根项目的build.gradle里用subprojects块统一配置：

plugins {
    id 'java'
}

group 'com.example'
version '1.0-SNAPSHOT'

// 给所有子模块统一配置规则
subprojects {
    apply plugin: 'java'

    repositories {
        mavenCentral()
    }

    dependencies {
        // 这里放所有子模块都需要的公共依赖
        // 比如 testImplementation 'org.slf4j:slf4j-api:1.7.36'
    }
}

这样子模块的build.gradle就能大幅简化，比如junit-module的build.gradle可以改成：

dependencies {
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.1'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.1'
}

test {
    useJUnitPlatform()
}

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