SpringCloud项目打包注意事项以及可能出错的几种情况

---

欢迎访问我的个人博客：https://wk-blog.vip

1、检查子模块中的 parent的pom文件路径 <relativePath/>

1.1、默认值

默认我们可以不用写 ，此时默认就是 ../pom.xml，会从当前目录的上一级目录中获取parent 的 pom

<parent><groupId>***</groupId><artifactId>***</artifactId><version>***</version>
</parent>

1.2、<relativePath/>

设定一个空值将始终从仓库中获取，不从本地路径获取（relativePath > 本地仓库 > 远程仓库）

<parent><groupId>***</groupId><artifactId>***</artifactId><version>***</version><relativePath/>
</parent>

1.3、<relativePath>某个pom的路径<relativePath/>

手动指定 parent的pom 位置

<parent><groupId>***</groupId><artifactId>***</artifactId><version>***</version><relativePath>../pom.xml</relativePath>
</parent>

2、检查打包插件的位置

打包插件的引入方式如下：

<build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build>

一般情况下，在开发SpringCloud项目时，都会抽离出一些公共模块，用来存放常用的工具类，配置类。这些模块是不需要启动运行的，而是单纯的作为一个依赖供其他模块使用，所以我们在打包的时候，这些作为依赖的模块是不需要引入打包插件的，并且也不需要提供 SpringBoot 启动类。

如果引入了打包插件，则可能会出现以下错误：

1. 没有SpringBoot启动类情况：

Failed to execute goal org.springframework.boot:spring-boot-maven-plugin:2.3.12.RELEASE:repackage (repackage) on project xxxxxx：Execution repackage of goal org.springframework.boot:spring-boot-maven-plugin:2.3.12.RELEASE:repackage failed: Unable to find main class

2. 存在SpringBoot启动类的情况：

Error:(4,29) java: 程序包xxxxxx不存在

---

对于需要通过SpringBoot启动的模块，则需要引入打包插件，一般我们都会将打包插件放在父模块中，例如 A 模块是整个项目的父模块，而 B 模块是 A 模块下的一个依赖模块，C 模块是 A 模块下的运行模块的父模块，D 是 C 模块下的运行模块，那么此时，就可以将 打包插件引入到 C 模块中，这样 C 模块下的所有运行模块都可以被maven成功打包为可运行的 jar 包。

3、检查module是否重复引用

如果出现module的重复引用，则打包的时候会出现以下错误：

Project 'xxxxxx' is duplicated in the reactor

重复引用的有以下几种方式：

假设 A模块 的 pom 中聚合了 B 和 C 两个子模块，此时如果子模块 B 引入了 C模块 作为自己的子模块，就会导致重复引入冲突。

或者 A模块 中聚合了 B模块，同时 A 的父模块 (假设是parent) 中也引入了 B模块 ，也会导致出现重复引入冲突。

• 重复引用1：C模块既让A模块引用，又让B模块引用（A模块是B和C的父模块）

    <artifactId>A</artifactId><packaging>pom</packaging><modules><module>B</module><module>C</module></modules>

    <artifactId>B</artifactId><packaging>pom</packaging><modules><module>C</module></modules>

• 重复引用2：A 的父模块中引入了 B模块或者C模块（A模块是B和C的父模块，parent是A的父模块）

	<artifactId>Parent</artifactId><packaging>pom</packaging><modules><module>A</module><module>A/B</module><module>A/C</module></modules>