鄂奎阿1. 问题现象与背景分析
"jar中没有主清单属性"这个错误信息对于使用Spring Boot进行项目开发的Java工程师来说并不陌生。当你在控制台看到这个错误时，通常意味着你尝试运行一个通过Maven打包生成的jar文件，但系统无法识别这个jar文件的入口点。
这个问题的本质在于Java的jar包规范要求MANIFEST.MF文件中必须包含Main-Class属性来指定可执行jar的入口类。而Spring Boot项目默认使用spring-boot-maven-plugin插件来打包，这个插件会自动处理清单文件(Manifest)的生成。当插件配置不正确或缺失时，就会导致生成的jar包缺少必要的主清单属性。
在实际开发中，这个问题经常出现在多模块项目中，特别是当你尝试为某个子模块(如module-basic)单独打包时。常见的错误场景包括：
- 在子模块的pom.xml中忘记添加spring-boot-maven-plugin插件
- 插件版本与Spring Boot版本不匹配
- 父pom中的插件配置被子模块覆盖或继承不正确
- 使用了不正确的打包命令或打包目标
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Spring Boot Maven插件核心配置解析
Spring Boot Maven插件(spring-boot-maven-plugin)是解决这个问题的关键。这个插件的主要职责之一就是在打包过程中生成正确的MANIFEST.MF文件，其中包含Main-Class和Start-Class属性。
2.1 基础配置示例
对于module-basic模块，正确的插件配置应该如下：
xml复制<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>${spring-boot.version}</version>
<executions>
<execution>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
这里有几个关键点需要注意：
- 插件版本应该与项目中使用的Spring Boot版本保持一致，通常通过${spring-boot.version}属性来管理
- repackage目标是必须的，它会将常规jar重新打包为可执行的Spring Boot jar
- 插件应该配置在需要打包为可执行jar的模块中
2.2 多模块项目中的特殊配置
在多模块项目中，配置方式会有一些变化。父pom中通常会这样声明插件管理：
xml复制<pluginManagement>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>${spring-boot.version}</version>
</plugin>
</plugins>
</pluginManagement>
然后在子模块(如module-basic)的pom.xml中，你需要显式地添加插件配置：
xml复制<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
注意：在多模块项目中，常见的错误是在父pom中配置了插件但没有在子模块中引用，或者在子模块中覆盖了父pom的配置导致插件失效。
3. 完整解决方案与验证步骤
3.1 逐步修复流程
-
检查pom.xml配置：
首先确认module-basic模块的pom.xml中是否包含spring-boot-maven-plugin的正确配置。如果缺失，按照上述示例添加。 -
验证插件版本：
确保插件版本与项目使用的Spring Boot版本匹配。可以通过以下命令检查：bash复制mvn dependency:tree | grep 'spring-boot' -
执行正确的打包命令：
使用以下命令进行打包：bash复制
mvn clean package或者针对特定模块：
bash复制
mvn clean package -pl module-basic -am -
验证生成的jar包：
打包完成后，检查生成的jar文件：bash复制
jar tf target/module-basic-0.0.1-SNAPSHOT.jar | grep MANIFEST.MF然后查看清单文件内容：
bash复制
unzip -p target/module-basic-0.0.1-SNAPSHOT.jar META-INF/MANIFEST.MF应该能看到类似这样的内容：
code复制Main-Class: org.springframework.boot.loader.JarLauncher Start-Class: com.example.modulebasic.ModuleBasicApplication
3.2 常见问题排查表
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 打包后没有主清单属性 | spring-boot-maven-plugin未配置或配置错误 | 检查并添加正确的插件配置 |
| 打包后jar文件很小(只有几KB) | 可能只打包了模块本身，没有包含依赖 | 确保使用了repackage目标 |
| 运行时找不到主类 | Start-Class配置不正确 | 检查@SpringBootApplication注解的主类路径 |
| 依赖项未解析 | 父pom中的dependencyManagement配置问题 | 检查父pom的Spring Boot依赖管理 |
| 插件执行失败 | 插件版本与Spring Boot版本不兼容 | 统一版本号，使用属性管理 |
4. 高级配置与优化建议
4.1 自定义清单属性
除了基本的配置外，你还可以自定义生成的MANIFEST.MF文件内容：
xml复制<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<mainClass>com.example.modulebasic.ModuleBasicApplication</mainClass>
<layout>JAR</layout>
<executable>true</executable>
<manifest>
<addDefaultImplementationEntries>true</addDefaultImplementationEntries>
<addDefaultSpecificationEntries>true</addDefaultSpecificationEntries>
</manifest>
</configuration>
</plugin>
4.2 构建信息添加
Spring Boot还支持在构建时添加额外的信息，这些信息可以通过/info端点访问：
xml复制<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<executions>
<execution>
<goals>
<goal>build-info</goal>
</goals>
</execution>
</executions>
</plugin>
4.3 分层构建优化
对于Docker部署场景，可以考虑使用分层构建来提高构建效率和启动速度：
xml复制<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<layers>
<enabled>true</enabled>
</layers>
</configuration>
</plugin>
5. 相关工具与技巧
5.1 使用Maven Helper分析依赖
在IntelliJ IDEA中，可以安装Maven Helper插件来可视化分析依赖关系，这对于解决"未解析的依赖项"问题特别有用。
5.2 检查依赖冲突
使用以下命令检查依赖冲突：
bash复制mvn dependency:tree -Dverbose -Dincludes=org.springframework.boot
5.3 反编译jar包
如果需要检查jar包内容，可以使用JD-GUI等工具进行反编译，但请注意遵守相关法律法规。
5.4 Docker部署技巧
对于Docker部署，一个基本的Dockerfile示例如下：
dockerfile复制FROM openjdk:17-jdk-slim
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","-jar","/app.jar"]
构建命令：
bash复制docker build -t module-basic .
运行命令：
bash复制docker run -p 8080:8080 module-basic
6. 实际案例分享
最近在一个金融项目中，我们遇到了一个典型的"jar中没有主清单属性"问题。项目结构如下：
code复制parent-pom
├── module-common
├── module-basic
└── module-web
问题出现在module-basic模块打包时。经过排查发现：
- 父pom中正确配置了spring-boot-maven-plugin
- module-web模块能正常打包
- module-basic模块打包失败
根本原因是module-basic的pom.xml中覆盖了build配置，但没有包含spring-boot-maven-plugin。解决方案是在module-basic的pom.xml中显式添加插件配置，同时确保不覆盖父pom的其他构建配置。
这个案例告诉我们，在多模块项目中，子模块的构建配置需要特别小心，特别是当子模块需要不同的构建逻辑时。