多模块Java Maven项目导入缺失编译失败问题求助

核心问题拆解 #

1. 循环依赖：cyp和apiService互相依赖，Maven不允许这种循环引用，会导致编译时无法正确解析依赖关系。
2. GroupId/ArtifactId不一致：
   • cyp模块groupId是org.cyp，apiService是com.cyp，命名混乱
   • 本地仓库中apiService的路径是com/cyp/fixApiService，但pom配置里artifactId是apiService，两者不匹配
3. 导入路径错误：导入语句未对应apiService模块中类的实际包结构，且依赖关系错误导致编译时找不到包。
4. 编译插件版本兼容问题：maven-compiler-plugin 3.8.1不支持Java 21，会引发编译兼容性问题。

分步解决 #

1. 修复循环依赖（关键） #

关注点分离的正确逻辑应该是编排逻辑（apiService）依赖业务逻辑（cyp），而不是互相依赖。业务逻辑模块不应该依赖上层的编排模块：

• 删除cyp模块pom.xml中对apiService的依赖：

<!-- 删除这段 -->
<dependency>
    <groupId>com.cyp</groupId>
    <artifactId>apiService</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</dependency>

• 如果两个模块有共享代码，抽成独立的common模块，让cyp和apiService都依赖这个common模块。

2. 统一GroupId与ArtifactId #

• 统一两个模块的groupId，比如都用org.cyp：
  • apiService模块pom.xml修改groupId：

  <groupId>org.cyp</groupId>
  <artifactId>apiService</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  

• 确保apiService模块的artifactId是apiService（和本地仓库的fixApiService不一致的话，修改pom后重新执行mvn clean install，覆盖本地仓库的错误版本）。

3. 修正导入语句 #

• 先查看apiService模块中需要导入的类的实际包路径，比如类在org.cyp.apiService.service下，导入语句应该是：

import org.cyp.apiService.service.YourServiceClass;

• 禁止直接导入包名（import com.cyp.apiService;），必须指定具体类，或使用通配符import com.cyp.apiService.*;（不推荐）。

4. 升级编译插件适配Java 21 #

在两个模块的pom.xml中添加或更新maven-compiler-plugin配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version> <!-- 支持Java 21的最低版本 -->
            <configuration>
                <source>21</source>
                <target>21</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>
    </plugins>
</build>

5. 重新执行Maven命令 #

1. 清理本地仓库中错误的模块：删除C:\Users\example\.m2\repository\com\cyp和C:\Users\example\.m2\repository\org\cyp下的相关文件夹
2. 先编译安装cyp模块：进入cyp模块目录，执行mvn clean install
3. 再编译安装apiService模块：进入apiService模块目录，执行mvn clean install

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