本文详解 spring boot 3.x 多模块项目编译失败的常见原因及系统性解决方案，重点涵盖父 pom 配置规范、模块依赖声明、maven 插件管理与注释格式陷阱，助你快速恢复 clean compile 和 package 流程。

本文详解 spring boot 3.x 多模块项目编译失败的常见原因及系统性解决方案，重点涵盖父 pom 配置规范、模块依赖声明、maven 插件管理与注释格式陷阱，助你快速恢复 clean compile 和 package 流程。

在 Spring Boot 3.x 环境下构建多模块项目时，即使各子模块可独立运行（如通过 IDE 启动 @SpringBootApplication 类），仍常出现 mvn clean compile 或 mvn package 失败的问题——典型表现为编译器无法解析跨模块的类导入（例如 cannot find symbol），或 Maven 报错 Could not resolve dependencies。这并非代码逻辑错误，而是项目结构与 Maven 构建生命周期协同失当所致。

关键配置要点

1. 父 POM 必须声明为 pom 打包类型，并禁用默认构建插件

   

   Spring Boot Actuator Analyzer

   分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

   下载

   <!-- parent/pom.xml -->
   <packaging>pom</packaging>
   <properties>
       <java.version>17</java.version>
       <spring-boot.version>3.2.5</spring-boot.version>
   </properties>
   <dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-dependencies</artifactId>
               <version>${spring-boot.version}</version>
               <type>pom</type>
               <scope>import</scope>
           </dependency>
       </dependencies>
   </dependencyManagement>

2. 正确声明 <pluginmanagement></pluginmanagement> 而非 <plugins></plugins>
   所有 Spring Boot 相关插件（如 spring-boot-maven-plugin）必须置于 <build><pluginmanagement></pluginmanagement></build> 下，不可直接写入 <plugins></plugins>，否则会导致子模块继承异常：

   <build>
       <pluginManagement>
           <plugins>
               <plugin>
                   <groupId>org.springframework.boot</groupId>
                   <artifactId>spring-boot-maven-plugin</artifactId>
                   <version>${spring-boot.version}</version>
               </plugin>
           </plugins>
       </pluginManagement>
   </build>

3. 警惕 XML 注释嵌套导致的解析失败
   原始问题中提到的 <!--/*/--> 是高危写法：若在 <dependencymanagement></dependencymanagement> 或 <pluginmanagement></pluginmanagement> 内部误用未闭合的注释（如 <!-- 后遗漏 -->），Maven 解析器将跳过后续全部配置，造成依赖/插件管理失效。务必确保所有注释严格成对闭合，推荐使用 IDE 的 XML 格式化功能校验结构。

4. 子模块需显式声明对其他模块的依赖
   例如 service-module 需调用 common-module 中的工具类，则其 pom.xml 必须包含：

   <dependencies>
       <dependency>
           <groupId>com.example</groupId>
           <artifactId>common-module</artifactId>
           <version>0.0.1-SNAPSHOT</version> <!-- 注意：多模块中 version 通常继承自 parent -->
       </dependency>
   </dependencies>

推荐验证流程

• 执行 mvn clean compile -X 查看详细日志，定位首个失败模块；
• 检查 target/classes 是否生成对应模块的 class 文件；
• 运行 mvn dependency:tree -Dverbose 确认跨模块依赖是否被正确解析；
• 彻底清理本地仓库缓存后重试：删除 ~/.m2/repository/com/example/ 下相关模块目录，再执行 mvn clean install -U。

⚠️ 注意：Spring Boot 3.x 要求 Java 17+、Jakarta EE 9+ 命名空间（如 jakarta.annotation 替代 javax.annotation），若子模块仍引用旧版 API，也会引发编译失败——此时需同步升级依赖并更新 import 语句。

遵循上述配置规范，90% 以上的多模块编译问题可被根治。核心原则是：父 POM 只做“声明”与“管理”，不参与实际编译；子模块各自负责“实现”与“依赖声明”；XML 结构零容错，注释亦需严谨。