Spring Boot 打包成的可执行 jar ，为什么不能被其他项目依赖？

Ali_ 发布于2019-08-16 18:31 / 608人阅读

摘要：从这里我们就可以看出，两个，虽然都是包，但是内部结构是完全不同的，因此一个可以直接执行，另一个则可以被其他项目依赖。一次打包两个一般来说，直接打包成可执行就可以了，不建议将作为普通的被其他的项目所依赖。

前两天被人问到这样一个问题:

“松哥，为什么我的 Spring Boot 项目打包成的 jar ，被其他项目依赖之后，总是报找不到类的错误？”

大伙有这样的疑问，就是因为还没搞清楚可执行 jar 和普通 jar 到底有什么区别？今天松哥就和大家来聊一聊这个问题。

多了一个插件

Spring Boot 中默认打包成的 jar 叫做可执行 jar，这种 jar 不同于普通的 jar，普通的 jar 不可以通过 java -jar xxx.jar 命令执行，普通的 jar 主要是被其他应用依赖，Spring Boot 打成的 jar 可以执行，但是不可以被其他的应用所依赖，即使强制依赖，也无法获取里边的类。但是可执行 jar 并不是 Spring Boot 独有的，Java 工程本身就可以打包成可执行 jar 。

有的小伙伴可能就有疑问了，既然同样是执行 mvn package 命令进行项目打包，为什么 Spring Boot 项目就打成了可执行 jar ，而普通项目则打包成了不可执行 jar 呢？

这我们就不得不提 Spring Boot 项目中一个默认的插件配置 spring-boot-maven-plugin ，这个打包插件存在 5 个方面的功能，从插件命令就可以看出：

五个功能分别是：

build-info：生成项目的构建信息文件 build-info.properties

repackage：这个是默认 goal，在 mvn package 执行之后，这个命令再次打包生成可执行的 jar，同时将 mvn package 生成的 jar 重命名为 *.origin

run：这个可以用来运行 Spring Boot 应用

start：这个在 mvn integration-test 阶段，进行 Spring Boot 应用生命周期的管理

stop：这个在 mvn integration-test 阶段，进行 Spring Boot 应用生命周期的管理

这里功能，默认情况下使用就是 repackage 功能，其他功能要使用，则需要开发者显式配置。

打包

repackage 功能的作用，就是在打包的时候，多做一点额外的事情：

首先 mvn package 命令对项目进行打包，打成一个 jar，这个 jar 就是一个普通的 jar，可以被其他项目依赖，但是不可以被执行

repackage 命令，对第一步打包成的 jar 进行再次打包，将之打成一个可执行 jar ，通过将第一步打成的 jar 重命名为 *.original 文件

举个例子：

对任意一个 Spring Boot 项目进行打包，可以执行 mvn package 命令，也可以直接在 IDEA 中点击 package ，如下：

打包成功之后， target 中的文件如下：

这里有两个文件，第一个 restful-0.0.1-SNAPSHOT.jar 表示打包成的可执行 jar ，第二个 restful-0.0.1-SNAPSHOT.jar.original 则是在打包过程中，被重命名的 jar，这是一个不可执行 jar，但是可以被其他项目依赖的 jar。通过对这两个文件的解压，我们可以看出这两者之间的差异。

两种 jar 的比较

可执行 jar 解压之后，目录如下：

可以看到，可执行 jar 中，我们自己的代码是存在于 BOOT-INF/classes/ 目录下，另外，还有一个 META-INF 的目录，该目录下有一个 MANIFEST.MF 文件，打开该文件，内容如下：

Manifest-Version: 1.0
Implementation-Title: restful
Implementation-Version: 0.0.1-SNAPSHOT
Start-Class: org.javaboy.restful.RestfulApplication
Spring-Boot-Classes: BOOT-INF/classes/
Spring-Boot-Lib: BOOT-INF/lib/
Build-Jdk-Spec: 1.8
Spring-Boot-Version: 2.1.6.RELEASE
Created-By: Maven Archiver 3.4.0
Main-Class: org.springframework.boot.loader.JarLauncher

可以看到，这里定义了一个 Start-Class，这就是可执行 jar 的入口类，Spring-Boot-Classes 表示我们自己代码编译后的位置，Spring-Boot-Lib 则表示项目依赖的 jar 的位置。

换句话说，如果自己要打一个可执行 jar 包的话，除了添加相关依赖之外，还需要配置 META-INF/MANIFEST.MF 文件。

这是可执行 jar 的结构，那么不可执行 jar 的结构呢？

我们首先将默认的后缀 .original 除去，然后给文件重命名，重命名完成，进行解压：

解压后可以看到，不可执行 jar 根目录就相当于我们的 classpath，解压之后，直接就能看到我们的代码，它也有 META-INF/MANIFEST.MF 文件，但是文件中没有定义启动类等。

Manifest-Version: 1.0
Implementation-Title: restful
Implementation-Version: 0.0.1-SNAPSHOT
Build-Jdk-Spec: 1.8
Created-By: Maven Archiver 3.4.0

注意

这个不可以执行 jar 也没有将项目的依赖打包进来。

从这里我们就可以看出，两个 jar ，虽然都是 jar 包，但是内部结构是完全不同的，因此一个可以直接执行，另一个则可以被其他项目依赖。

一次打包两个 jar

一般来说，Spring Boot 直接打包成可执行 jar 就可以了，不建议将 Spring Boot 作为普通的 jar 被其他的项目所依赖。如果有这种需求，建议将被依赖的部分，多带带抽出来做一个普通的 Maven 项目，然后在 Spring Boot 中引用这个 Maven 项目。

如果非要将 Spring Boot 打包成一个普通 jar 被其他项目依赖，技术上来说，也是可以的，给 spring-boot-maven-plugin 插件添加如下配置：


    
        
            org.springframework.boot
            spring-boot-maven-plugin
            
                exec

配置的 classifier 表示可执行 jar 的名字，配置了这个之后，在插件执行 repackage 命令时，就不会给 mvn package 所打成的 jar 重命名了，所以，打包后的 jar 如下：

第一个 jar 表示可以被其他项目依赖的 jar ，第二个 jar 则表示一个可执行 jar。

好了，关于 Spring Boot 中 jar 的问题，我们就说这么多，有问题欢迎留言讨论。

关注公众号【江南一点雨】，专注于 Spring Boot+微服务以及前后端分离等全栈技术，定期视频教程分享，关注后回复 Java ，领取松哥为你精心准备的 Java 干货！

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/75251.html

Spring Boot 参考指南（开发你的第一个Spring Boot应用程序）

摘要：开发你的第一个应用程序本节描述如何开发一个简单的应用程序来突出了的一些关键特性，我们使用来构建这个项目，因为大多数都支持它。如果你希望分发一个自包含的应用程序，这可能会有问题。 11. 开发你的第一个Spring Boot应用程序本节描述如何开发一个简单的Hello World! web应用程序来突出了Spring Boot的一些关键特性，我们使用Maven来构建这个项目，因为大多数...

Cristalven 2019-08-15 18:05 评论0 收藏0
Maven详细教程

摘要：清理上一次执行创建的文件处理资源文件编译代码执行单元测试文件创建拷贝到本地的仓库下面发布生成文档将工程所有文档生成网站，生成的网站界面默认和的项目站点类似，但是其文档用格式写的，目前不支持，需要用其他插件配合才能支持。前言本文可以帮助你加深对Maven的整体认识，不是一篇基础文章。如果你现在还没有用 Maven 跑过 HelloWorld，那么本文可能不适合你。一、Maven简介...

Keagan 2019-08-15 18:00 评论0 收藏0
使用Spring实现上传文件

摘要：要使用容器上传文件，您需要注册一个类在中。最好不要使用内容加载应用程序的文件系统。允许用户上传文件的表单从后端提供的文件列表调整文件上传限制配置文件上传时，设置文件大小限制通常很有用。本指南将指导您完成创建可以接收HTTP多文件上传服务器应用程序的过程。你要构建什么您将创建一个接受文件上传的Spring Boot Web应用程序。您还将构建一个简单的HTML界面来上传测试文件。 ...

yuanzhanghu 2019-08-16 14:44 评论0 收藏0
Spring Boot 参考指南（开发者工具）

摘要：触发器文件可以手动更新，也可以使用插件进行更新。例如，要配置重新启动以始终使用触发器文件，你需要添加以下属性远程应用程序开发工具并不局限于本地开发，在远程运行应用程序时，还可以使用几个特性。 20. 开发者工具 Spring Boot包括一组额外的工具，这些工具可以使应用程序开发体验变得更加愉快，spring-boot-devtools模块可以包含在任何项目中，以提供额外的develo...

APICloud 2019-08-15 17:56 评论0 收藏0
Spring 指南（构建RESTful Web服务）

摘要：构建服务本指南将引导你完成使用创建服务的过程。接下来，你将创建将为这些问候语提供服务的资源控制器。告诉在包中查找其他组件配置和服务，允许它找到控制器。显示日志输出，该服务应在几秒内启动并运行。构建RESTful Web服务本指南将引导你完成使用Spring创建hello world RESTful Web服务的过程。将要构建什么你将构建一个接受HTTP GET请求的服务： ht...

yzzz 2019-08-16 14:40 评论0 收藏0