<think>我们正在解决一个特定的
Maven构建错误：`
Execution repackage
of goal org.springframework.boot:spring-boot-maven-plugin:2
.4
.2
:repackage failed`，具体错误信息是`Unable to find main class`。根据提供的引用，这个问题通常发生在
Spring Boot Maven插件尝试重新
打包（repackage）
时找不到主类。
分析原因：
1. **主类未明确指定**：
Spring Boot Maven插件需要知道哪个类包含`main`方法作为应用程序的入口。如果
项目中只有一个主类，插件通常可以自动找到，但如果有多个或没有，就需要明确指定。
2
. **
项目结构问题**：可能是一个非
Spring Boot项目（如工具类
项目）被误用了
Spring Boot的
打包插件，因为工具类
项目通常不需要主类（如引用[3]所述）。
3
. **插件配置问题**：在pom
.xml中，可能缺少了指定主类的配置，或者配置不正确。
解决方案：
根据引用[
5]，我们可以在插件的配置中明确指定主类。另外，引用[3]提到，如果
项目本身不需要主类，那么就不应该使用`
spring-boot-maven-plugin`的repackage目标，因为该目标会尝试将
项目打包成可执行的jar（需要主类）。
因此，我们有两种情况：
**情况
1：
项目是
Spring Boot应用程序（需要主类）**
- 确保在`
spring-boot-maven-plugin`的配置中指定主类，例如：
```xml
<configuration>
<mainClass>com
.example
.YourMainClass</mainClass>
</configuration>
```
其中`com
.example
.YourMainClass`是你的应用程序主类的全限定名。
**情况2：
项目不是
Spring Boot应用程序（不需要主类）**
- 如果
项目是一个普通的工具库，不应该
打包成可执行的jar，那么可以移除`
spring-boot-maven-plugin`插件，或者跳过repackage目标。
但是，引用[4]显示
项目继承了`
spring-boot-starter
-parent`，这意味着它可能是一个
Spring Boot项目。因此，我们更倾向于情况
1的解决方案。
具体步骤：
1. **在pom
.xml中明确指定主类**：
在`
spring-boot-maven-plugin`的配置块内添加`<configuration>`指定主类。
示例配置（参考引用[
5]）：
```xml
<build>
<
plugins>
<
plugin>
<groupId>
org.springframework.boot</groupId>
<artifactId>
spring-boot-maven-plugin</artifactId>
<version>2
.4
.2</version> <!
-- 使用你实际的版本
-->
<configuration>
<mainClass>com
.xx
.webapps
.api
.main
.WebappsApiBidMain</mainClass> <!
-- 替换为你的主类
-->
</configuration>
<
executions>
<
execution>
<
goals>
<
goal>repackage</
goal>
</
goals>
</
execution>
</
executions>
</
plugin>
</
plugins>
</build>
```
2
. **检查主类是否存在**：
确保指定的主类在
项目中存在，并且包含`public static void main(String[] args)`方法。
3
. **如果
项目不需要主类**（如工具库）：
考虑移除`
spring-boot-maven-plugin`插件，或者跳过repackage目标。可以通过配置跳过：
```xml
<
executions>
<
execution>
<id>repackage</id>
<phase>none</phase>
</
execution>
</
executions>
```
或者完全移除插件。
4
. **检查主类的包路径**：
确保在配置中写的主类全限定名正确，包括包名和类名。
5. **使用
Maven命令重新
打包**：
在配置完成后，重新运行
Maven命令：
```bash
mvn clean package
```
如果问题仍然存在，可以使用`
-X`参数来获取详细的调试信息，帮助定位问题：
```bash
mvn clean package
-X
```
在调试日志中，可以搜索与主类相关的信息，看插件是如何寻找主类的。
另外，引用[3]提到，如果
项目是一个通用工具类
项目（非
Spring Boot应用），那么它不应该使用`
spring-boot-maven-plugin`的repackage目标。因此，请根据
项目的实际类型选择解决方案。
最后，注意插件版本与
Spring Boot版本的兼容性，建议使用与
Spring Boot版本匹配的插件版本。
希望这些步骤能帮助解决问题。</think>### 解决
Maven 构建失败：
Spring Boot Repackage 错误
当执行 `mvn package`
时遇到 `
Execution repackage
of goal org.springframework.boot:spring-boot-maven-plugin:2
.4
.2
:repackage failed
: Unable to find main class` 错误，通常是由于
Spring Boot 插件无法定位主类。以下是系统化的解决方案：
---
####
1. **明确指定主类（推荐方案）**
在 `pom
.xml` 的插件配置中添加 `<configuration>` 明确声明主类：
```xml
<
plugin>
<groupId>
org.springframework.boot</groupId>
<artifactId>
spring-boot-maven-plugin</artifactId>
<version>2
.4
.2</version>
<configuration>
<!
-- 替换为您的实际主类
-->
<mainClass>com
.example
.YourApplication</mainClass>
</configuration>
<
executions>
<
execution>
<
goals>
<
goal>repackage</
goal>
</
goals>
</
execution>
</
executions>
</
plugin>
```
> **关键点**：
>
- 主类需包含标准的 `public static void main(String[] args)` 方法
>
- 使用全限定类名（包名+类名）[^
5]
---
#### 2
. **检查
项目类型**
若
项目是**非可执行模块**（如工具库），需跳过 repackage：
```xml
<
plugin>
<groupId>
org.springframework.boot</groupId>
<artifactId>
spring-boot-maven-plugin</artifactId>
<configuration>
<skip>true</skip> <!
-- 禁用可执行JAR生成
-->
</configuration>
</
plugin>
```
> **适用场景**：
>
- 工具类
项目（无 `main` 方法）[^3]
>
- 被其他模块依赖的公共库
---
#### 3
. **验证主类存在性**
检查主类文件是否在正确位置：
```bash
# 示例路径（根据实际包结构调整）
src/main/java/com/example/YourApplication
.java
```
> **常见问题**：
>
- 文件路径与包声明不匹配
>
- 缺少 `@
SpringBootApplication` 注解
>
- 构建
时被资源过滤排除
---
#### 4
. **调试构建过程**
使用 `
-X` 参数获取详细日志：
```bash
mvn clean package
-X | grep
-A 20 "
spring-boot-maven-plugin"
```
在日志中检查：
```log
[DEBUG] Searching for main class
...
[DEBUG] Candidate main class
: com
.example
.ClassA
[DEBUG] Candidate main class
: com
.example
.ClassB
[ERROR] Unable to find main class
```
> 日志会列出所有候选类，帮助确认插件识别了哪些类[^
1]
---
####
5. **版本兼容性处理**
确保插件版本与
Spring Boot 父 POM 一致：
```xml
<parent>
<groupId>
org.springframework.boot</groupId>
<artifactId>
spring-boot-starter
-parent</artifactId>
<version>2
.4
.2</version> <!
-- 与插件版本一致
-->
</parent>
```
> **版本冲突表现**：
>
- 父 POM 声明旧版本（如 2
.2
.0）[^4]
>
- 插件显式声明新版本（如 2
.4
.2）
---
#### 6
. **多模块
项目特殊处理**
对于子模块，在主 POM 中全局配置：
```xml
<
pluginManagement>
<
plugins>
<
plugin>
<groupId>
org.springframework.boot</groupId>
<artifactId>
spring-boot-maven-plugin</artifactId>
<configuration>
<mainClass>com
.example
.MainApplication</mainClass>
</configuration>
</
plugin>
</
plugins>
</
pluginManagement>
```
> **注意**：非启动模块需按方案2跳过 repackage
---
### 根本原因分析
| 问题类型 | 发生场景 | 解决方案 |
|
-------------------------|
-----------------------------------|
------------------------|
| **主类未声明** | 多 `main` 方法或路径错误 | 方案
1（显式指定） |
| **非可执行模块** | 工具库/公共依赖包 | 方案2（跳过repackage）|
| **版本冲突** | 父POM与插件版本不一致 | 方案
5（版本对齐） |
| **构建过程过滤** | 资源过滤排除了主类 | 检查资源配置 |
通过以上步骤，9
5% 的 "Unable to find main class" 错误可被解决。若问题仍存在，请提供 `
-X` 日志片段进一步分析[^
1]。
本文详细介绍了在 优快云 博客中转载文章的正确方式和注意事项，确保尊重原创作者的版权，同时分享有价值的内容。
扫一扫
4万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
