Maven多模块循环依赖问题排查与跨模块通信方案咨询

你的配置存在两个核心错误，这是循环依赖的直接来源：

• packaging为pom的父工程，核心作用是聚合模块构建、统一依赖版本管理，禁止在父POM的<dependencies>节点中直接引入自身子模块。父POM的<dependencies>下的所有依赖会被所有子模块强制继承，等价于两个子模块同时互相依赖，天然构成循环引用。这类架构层面的循环依赖，靠依赖排除、重复依赖忽略、插件配置都无法解决，是Maven构建生命周期的固有规则决定的。
• 多模块项目的依赖必须是单向无环的，你当前的业务流程是「binance-api-custom拉取原始数据 → influxdb-controller做预处理入库」，本身是单向流程，不需要双向依赖。

方案1：配置单向依赖（适配你当前场景，改动量最小） #

你的业务流程是单向流转，不需要双向调用，按以下步骤修改即可：

1. 清空父POM<dependencies>节点下引入的两个子模块依赖。如果要统一子模块的版本号，把这两个依赖移到<dependencyManagement>节点下做版本声明即可，不要放在全局继承的<dependencies>里。
   父POM修改后的核心配置参考：

   <groupId>com.algoframework</groupId>
   <artifactId>AlgoFramework</artifactId>
   <packaging>pom</packaging>
   <version>1.0</version>
   
   <modules>
       <module>binance-api-custom</module>
       <module>influxdb-controller</module>
   </modules>
   
   <!-- 仅做版本管理，子模块按需引入，不会强制继承 -->
   <dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>com.algoframework</groupId>
               <artifactId>binance-api-custom</artifactId>
               <version>${project.version}</version>
           </dependency>
           <dependency>
               <groupId>com.algoframework</groupId>
               <artifactId>influxdb-controller</artifactId>
               <version>${project.version}</version>
           </dependency>
           <!-- 其他第三方依赖的版本统一在这里声明即可 -->
       </dependencies>
   </dependencyManagement>
   
   <properties>
       <maven.compiler.source>18</maven.compiler.source>
       <maven.compiler.target>18</maven.compiler.target>
   </properties>
   

2. 按照数据流转方向配置单向依赖：因为binance-api-custom拿到数据后需要调用influxdb-controller的预处理能力，所以只在binance-api-custom模块的POM中引入influxdb-controller依赖，反向绝对不能引入。
   在binance-api-custom的<dependencies>节点下追加：

   <dependency>
       <groupId>com.algoframework</groupId>
       <artifactId>influxdb-controller</artifactId>
   </dependency>
   

3. 确认influxdb-controller模块的依赖中没有引入binance-api-custom，保持依赖链路单向，重新构建即可消除循环依赖报错。

方案2：抽取公共模块（适配后续双向交互、多模块复用的场景） #

如果后续两个模块需要双向调用，或者存在大量共用的数据模型、工具类、接口定义，可以新增第三个公共子模块（比如命名为common-core）做解耦：

1. 新建common-core子模块，将两个模块交互用到的实体类、接口定义、公共工具类全部下沉到这个模块。
2. binance-api-custom和influxdb-controller两个业务模块都只依赖common-core，互相之间不直接依赖。
3. 交互时通过接口解耦：比如在common-core中定义数据预处理的标准接口DataPreHandler，influxdb-controller中编写该接口的实现逻辑，binance-api-custom拉取到数据后，面向接口调用处理方法即可，不需要直接依赖influxdb-controller的具体实现。如果是Spring生态项目直接配合依赖注入即可，纯Java项目可以通过SPI机制加载实现类，从根源上避免循环依赖。

• 父POM的<dependencies>节点下只适合放所有子模块100%会用到的公共基础依赖（比如日志包、工具类包），业务模块依赖、子模块依赖都不要直接放在这里，避免不必要的强制依赖引入。
• 多模块项目必须保持依赖链路无环，循环依赖本质是架构设计问题，不存在配置层面的绕过方式，必须通过调整依赖方向、拆分模块解耦解决。

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