Gradle多入口库场景：如何将根项目类路径注入子项目依赖？

看起来你碰到了Gradle多项目依赖里的一个常见坑——循环依赖限制。你现在的结构是根项目依赖子项目，但子项目要调用根项目的类，直接反向依赖会触发循环依赖报错，而且Gradle本身也不允许这种情况。下面是最合理的解决方案：

核心思路：拆分共享代码到独立子项目 #

Gradle的项目依赖是单向的，要避免循环依赖，最好的做法是把根项目中需要被子项目调用的代码（比如你的MainClass）抽出来，放到一个专门的共享核心子项目（比如:core）里。这样根项目和所有入口子项目都依赖这个:core，既解决了类访问问题，又符合Gradle的依赖设计。

具体步骤 #

1. 创建:core子项目
   在根目录下新建core文件夹，把根项目里的MainClass以及其他需要共享的代码移到这个子项目的源码目录中（比如core/src/main/java/）。记得给:core配置基础的Gradle构建脚本：

   // core/build.gradle
   plugins {
       id 'java'
   }
   
   // 这里可以加core项目的专属依赖，如果有的话
   dependencies {
       // 比如 implementation 'some.shared:library:1.0'
   }
   

2. 调整根项目依赖
   修改根项目的build.gradle，加上对:core的依赖，同时保留对入口子项目的依赖：

   // root/build.gradle
   dependencies {
       implementation project(':core')
       implementation project(':server')
       // 如果有gui子项目，同样加上
       // implementation project(':gui')
   }
   

3. 给入口子项目添加:core依赖
   到每个入口子项目（比如:server、:gui）的build.gradle里，添加对:core的依赖，这样子项目就能访问MainClass了：

   // server/build.gradle
   dependencies {
       // 保留子项目的专属依赖
       // 比如 implementation 'com.some:server-lib:2.0'
       
       // 添加核心子项目依赖
       implementation project(':core')
   }
   

为什么这能解决问题？ #

现在的依赖链是：

• 根项目 → :core + :server/:gui
• :server/:gui → :core
  完全没有循环依赖，每个项目的类路径都能正确包含需要的代码。你在:server里就能正常实例化MainClass了：

// server项目中的代码
import com.yourpackage.MainClass;

public class ServerEntry {
    public static void main(String[] args) {
        MainClass mainInstance = new MainClass();
        // 调用MainClass的方法
    }
}

不推荐的临时方案（慎选） #

如果暂时不想重构代码，有人会尝试让子项目依赖根项目的输出，但这会直接触发循环依赖（根依赖子项目，子项目又依赖根），Gradle会直接报错，而且这种结构会让构建逻辑变得混乱，后续维护成本极高，所以强烈建议用前面的拆分方案。

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