【Exception】spring-boot-maven-plugin 打包多模块项目 BUILD FAILURE 集锦

最新推荐文章于 2026-07-01 16:25:30 发布

原创最新推荐文章于 2026-07-01 16:25:30 发布 · 1.1k 阅读

0 ·

本内容遵循CC 4.0 BY-SA版权协议

本文为【tanpenggood】原创文章，允许转载，但转载必须注明出处并附带首发链接！

收录于

Exception

本文详细解析了SpringBoot项目中子工程依赖失败的问题，特别是在Maven打包时出现的“程序包不存在”错误，提供了具体的配置修改方案，确保子工程能够正确引用父工程中的通用工具类。

项目结构如下：

parent（父类工程）
	| - - - common（通用工具类子工程）
	| - - - projectA（springboot子工程，依赖common工程）

1、程序包XXX不存在

问题描述：

通过parent父工程进行Maven install，parent父工程和common子工程打包成功，projectA子工程打包失败并报错

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.7.0:compile (default-compile) on project client: Compilation failure: Compilation failure:
[ERROR] /E:/code/aden/check-system/client/src/main/java/com/aden/controller/LoginController.java:[3,24] 程序包com.aden.service不存在
[ERROR] /E:/code/aden/check-system/client/src/main/java/com/aden/controller/LoginController.java:[31,13] 找不到符号

注意：就算projectA能打包成功，运行后调用，也会报common下的类找不到异常，为同一问题

关键错误信息截图：
在这里插入图片描述
解决方案：

在common子工程下的pom.xml，添加以下配置

<build>
	<plugins>
		<plugin>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-maven-plugin</artifactId>
			<configuration>
				<!--给可执行jar包添加后缀，防止和编译jar包重名导致覆盖了编译jar包，使依赖的模块编译失败-->
				<classifier>exec</classifier>
			</configuration>
		</plugin>
	</plugins>
</build>

原因分析：

common也是SpringBoot工程，SpringBoot工程打包编译时，会生成两种jar包，一种是普通的jar，另一种是可执行jar。
默认情况下，这两种jar的名称相同，在不做配置的情况下，普通的jar先生成，可执行jar后生成，造成可执行jar会覆盖普通的jar。而projectA工程无法依赖common工程的可执行jar，所以编译失败：程序包xxx不存在。

添加配置后截图如下，其中common-1.0-SNAPSHOT-exec.jar为可执行jar，common-1.0-SNAPSHOT.jar为普通jar包。
在这里插入图片描述

2、Unable to find main class

错误信息：
在这里插入图片描述
解决方案：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
            	<!--设置入口函数-->
                <mainClass>com.aden.Application</mainClass>
            </configuration>
        </plugin>
    </plugins>
</build>