脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → java → SpringBoot Maven打包后运行失败解决

SpringBoot使用Maven打包后运行失败的问题解决详解

 更新时间：2025年07月16日 08:44:36   作者：超级小忍  
在使用 Spring Boot 开发项目时,我们通常会使用 Maven 作为构建工具,但有时会出现运行失败的情况,本文将从多个角度分析常见错误场景,并提供详细的排查和解决方案,希望对大家有所帮助

前言

在使用 Spring Boot 开发项目时，我们通常会使用 Maven 作为构建工具。Maven 负责依赖管理、编译、打包等任务。但在实际开发中，经常遇到一个问题：Spring Boot 项目在本地运行正常，但使用 mvn package 打包成 JAR 后却无法运行或启动失败。

本文将从多个角度分析常见错误场景，并提供详细的排查和解决方案，帮助你彻底解决 Spring Boot Maven 打包后运行失败的问题。

一、问题背景

Spring Boot 应用默认使用 spring-boot-maven-plugin 插件进行打包，生成一个包含所有依赖的可执行 JAR 文件（俗称“fat jar”）。然而，在某些情况下，构建后的 JAR 文件可能缺少主类、依赖未正确打包、配置文件缺失等问题，导致运行时报错。

二、常见错误类型及解决方案

1. 缺少主类信息（no main manifest attribute）

现象

no main manifest attribute, in your-app.jar

原因

JAR 包中的 MANIFEST.MF 文件没有指定主类（Main-Class），Java 无法识别程序入口点。

解决方案

确保在 pom.xml 中正确配置了 spring-boot-maven-plugin 插件，并显式指定主类：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <mainClass>com.example.demo.DemoApplication</mainClass>
            </configuration>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

或者，如果你使用的是 Spring Boot 的 parent POM，则可以直接启用插件而无需额外配置：

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

验证方法

查看 JAR 包中的 MANIFEST 是否包含主类信息：

unzip -p your-app.jar META-INF/MANIFEST.MF

2. 类找不到（ClassNotFoundException / NoClassDefFoundError）

现象

java.lang.ClassNotFoundException: com.example.service.SomeService

原因

  • 依赖未被正确打包进最终的 JAR 文件
  • 某些依赖的作用域设置为 provided 或 test
  • 没有使用 spring-boot-maven-plugin 插件

解决方案

确保依赖作用域正确：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <!-- 不要使用 provided -->
</dependency>

使用 spring-boot-maven-plugin 进行 repackage：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>

查看 JAR 包中是否包含目标类：

jar tf your-app.jar | grep SomeService.class

3. 配置文件未被打包或路径不对

现象

应用启动时报错：

Could not load property source from location 'classpath:/application.properties'

原因

  • 配置文件未放在标准目录 src/main/resources 下
  • Maven 打包时未启用资源过滤（filtering）

解决方案

  • 将配置文件放在 src/main/resources 目录下
  • 如果需要替换占位符（如 ${my.property}），请启用资源过滤：
<resources>
    <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
    </resource>
</resources>

查看 JAR 包中是否包含配置文件：

jar tf your-app.jar | grep application.properties

4. 多模块项目打包问题

现象

子模块依赖未正确打包，导致类找不到或主程序找不到。

原因

  • 子模块未安装到本地仓库
  • 主模块未正确声明依赖关系

解决方案

在父项目的 pom.xml 中定义模块顺序：

<modules>
    <module>common</module>
    <module>web</module>
</modules>

在主模块中添加对子模块的依赖：

<dependency>
    <groupId>com.example</groupId>
    <artifactId>common</artifactId>
    <version>1.0.0</version>
</dependency>

构建前先执行：

mvn clean install

主模块中使用 spring-boot-maven-plugin 插件重新打包：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>

5. JDK 版本不一致导致的错误

现象

java.lang.UnsupportedClassVersionError: major.minor version 61.0

原因

编译环境与运行环境使用的 Java 版本不一致。

解决方案

统一编译与运行环境的 JDK 版本，在 pom.xml 中指定编译版本：

<properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
</properties>

6. 打包命令使用错误

现象

构建的 JAR 文件缺失内容或不可执行

正确做法

使用以下命令进行打包：

mvn clean package

确保 target/your-app.jar 是一个完整的、可执行的 Spring Boot 应用。

三、推荐的排查步骤

步骤操作说明
1查看日志定位具体错误堆栈
2检查 JAR 内容jar tf your-app.jar
3检查主类信息unzip -p your-app.jar META-INF/MANIFEST.MF
4验证依赖完整性查看 BOOT-INF/lib/ 目录是否存在
5本地测试运行java -jar your-app.jar

四、完整示例：pom.xml 配置模板

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>1.0.0</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.3.1</version>
        <relativePath/>
    </parent>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>

    <build>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <filtering>true</filtering>
            </resource>
        </resources>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <mainClass>com.example.demo.DemoApplication</mainClass>
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

五、总结

问题类型常见表现解决方案
缺少主类no main manifest attribute配置 <mainClass>
类找不到ClassNotFoundException检查依赖 + repackage
配置文件缺失找不到 application.properties放入 resources + filtering
多模块问题类找不到先 install 子模块
JDK 版本不一致UnsupportedClassVersionError统一 source/target JDK
插件配置错误构建失败或不可执行正确使用 spring-boot-maven-plugin

六、结语

Spring Boot + Maven 是现代 Java Web 开发的标准组合，但打包过程中的细节容易出错。通过理解构建流程、掌握关键插件的使用以及学会如何检查 JAR 包内容，你可以快速定位并修复大多数打包运行失败的问题。

到此这篇关于SpringBoot使用Maven打包后运行失败的问题解决详解的文章就介绍到这了,更多相关SpringBoot Maven打包后运行失败解决内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

相关文章

  • springcloud本地配置优先方式

    springcloud本地配置优先方式

    这篇文章主要介绍了springcloud本地配置优先方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-07-07
  • SpringBoot中ApplicationEvent和ApplicationListener用法小结

    SpringBoot中ApplicationEvent和ApplicationListener用法小结

    这篇文章介绍SpringBoot中ApplicationEvent用法,注意ApplicationEvent和MQ队列虽然实现的功能相似，但是MQ还是有其不可替代性的，最本质的区别就是MQ可以用于不同系统之间的消息发布，而SpringEvent这种模式只能在一个系统中，需要的朋友可以参考下
    2023-03-03
  • 解析springboot整合谷歌开源缓存框架Guava Cache原理

    解析springboot整合谷歌开源缓存框架Guava Cache原理

    本文主要为大家解析了springboot整合谷歌开源缓存框架Guava Cache的原理以及在实际开发过程中的使用，附含源码，有需要的朋友可以参考下
    2021-08-08
  • Spring Boot常用注解(经典干货)

    Spring Boot常用注解(经典干货)

    Spring Boot是一个快速开发框架，快速的将一些常用的第三方依赖整合,全部采用注解形式，内置Http服务器,最终以Java应用程序进行执行,这篇文章主要介绍了Spring Boot常用注解（绝对经典）,需要的朋友可以参考下
    2023-01-01
  • Java 实战项目之在线点餐系统的实现流程

    Java 实战项目之在线点餐系统的实现流程

    读万卷书不如行万里路，只学书上的理论是远远不够的，只有在实战中才能获得能力的提升，本篇文章手把手带你用java+SSM+jsp+mysql+maven实现一个在线点餐系统,大家可以在过程中查缺补漏，提升水平
    2021-11-11
  • java的equals和==的比较示例

    java的equals和==的比较示例

    这篇文章主要介绍了java的equals和==的比较示例,需要的朋友可以参考下
    2014-04-04
  • SpringSecurityOAuth2实现微信授权登录

    SpringSecurityOAuth2实现微信授权登录

    微信的登录功能是用户注册和使用微信的必经之路之一,而微信授权登录更是方便了用户的登录操作,本文主要介绍了SpringSecurityOAuth2实现微信授权登录,感兴趣的可以了解一下
    2023-09-09
  • mybatis-plus实体类主键策略有3种(小结)

    mybatis-plus实体类主键策略有3种(小结)

    这篇文章主要介绍了mybatis-plus实体类主键策略有3种(小结)，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2020-08-08
  • 关于@GetMapping和@GetMapping(value=““)的区别

    关于@GetMapping和@GetMapping(value=““)的区别

    这篇文章主要介绍了关于@GetMapping和@GetMapping(value=““)的区别说明，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
    2022-05-05
  • Java线程的全方位详解

    Java线程的全方位详解

    Java 给多线程编程提供了内置的支持。 一条线程指的是进程中一个单一顺序的控制流，一个进程中可以并发多个线程，每条线程并行执行不同的任务，多线程是多任务的一种特别的形式，但多线程使用了更小的资源开销
    2021-10-10

最新评论