Maven编译多模块Spring项目报错：依赖util模块提示找不到符号

核心问题根因（90%概率匹配你的场景） #

你当前的父POM将spring-boot-maven-plugin配置在了全局构建插件列表中，所有子模块都会继承该插件的执行逻辑：

• 该插件默认会将模块打包为Spring Boot可执行JAR，可执行JAR的类存放在BOOT-INF/classes路径下，不符合普通依赖JAR的标准结构，其他模块依赖时无法读取到对应类
• 对于没有启动主类的公共模块（util、shared），该插件的重打包逻辑还可能打断正常编译流程，导致class文件未生成

分步修复操作 #

1. 修正spring-boot-maven-plugin配置 #

两种方案二选一即可：

• 方案1：将父POM中spring-boot-maven-plugin的完整配置删除，仅在有Spring Boot启动主类的业务模块（比如authserver、productmanager等实际运行的服务模块）的单独pom.xml中添加该插件配置
• 方案2：保留父POM中的插件配置，新增跳过逻辑，仅在需要的子模块开启：
  在父POM的spring-boot-maven-plugin配置中添加skip参数：

  <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <configuration>
          <skip>true</skip>
      </configuration>
  </plugin>
  

  然后在需要打包为可执行JAR的业务子模块的pom.xml中，添加该插件并关闭skip：

  <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <configuration>
          <skip>false</skip>
      </configuration>
  </plugin>
  

2. 调整模块编译顺序 #

将父POM的<modules>列表调整为被依赖优先级从高到低的顺序，避免依赖未编译就加载的问题：

<modules>
    <module>../agiletunes-util</module>
    <module>../agiletunes-shared</module>
    <module>../agiletunes-productmanager</module>
    <module>../agiletunes-testmanager</module>
    <module>../agiletunes-authserver</module>
</modules>

3. 校验shared模块依赖配置 #

打开agiletunes-shared模块的pom.xml，确认已经正确添加util模块的依赖：

<dependencies>
    <dependency>
        <groupId>com.agiletunes</groupId>
        <artifactId>agiletunes-util</artifactId>
        <version>0.0.1</version>
    </dependency>
    <!-- 其他依赖 -->
</dependencies>

4. 无关提示忽略说明 #

你遇到的versions:display-plugin-updates命令提示“未定义Maven最低版本”属于插件本身的通用提示，和你是否配置enforcer插件无关，直接忽略即可，不影响正常构建。

验证操作 #

修复完成后执行以下命令重新构建：
mvn clean install -U
参数-U用于强制更新本地依赖缓存，避免旧缓存导致的异常。

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