Springboot項目打包成jar運行2種方式

最近公司有個項目需要移植到SpringBoot框架上，項目里面又有許多第三方jar包，在linux服務器上最方便的就是用jar的方式來運行SpringBoot項目了，因此我研究了2種打jar包的方式，記錄如下，供大家參考：

1、通過maven插件，將所有依賴包都打包成一個jar包，然后通過java -jar xxx.jar方式運行

由於項目中有些jar包是第三方的，maven官方倉庫沒有，需要使用mvn install命令打包到本地，然后將其寫入到pom.xml的依賴中，maven倉庫有的jar包則從maven官網找到對應版本的depdency寫入pom文件里面，這樣maven打包就可以包含第三方jar包了，否則maven只會打包pom文件里面的，不會包括第三方jar包，程序運行將報錯。這里推薦2種打包第三方jar包的方式：

第一種：打包第三方jar包到本地倉庫，然后在pom.xml中引入

例如：將alipay-sdk-abc.jar 打包到本地倉庫

mvn命令：

‪mvn install:install-file -Dfile=‪G:\thirdpartyjar\alipay-sdk-abc.jar -DgroupId=com.thirdparty -DartifactId=alipay-sdk-abc -Dversion=3.1.0.8 -Dpackaging=jar

pom.xml配置：

<dependency>

    <groupId>com.thirdparty</groupId>

    <artifactId>alipay-sdk-abc</artifactId>

    <version>3.1.0.8</version>

</dependency>

 

然后在cmd或者IDEA的terminal里面使用mvn clean package -X命令清理、打包成jar文件，-X命令可以看到具體的打包輸出，便於分析。

這里用到了2個plugin，一個是普通的maven插件用於將各種jar包打包到一起，可是這樣的jar包是無法運行的，因為jar包里面沒有啟動類信息，還需要SpringBoot的maven插件進行repackage，這樣生成的jar包就包含啟動信息，才可以運行，關鍵配置如下：

<plugin>

    <groupId>org.apache.maven.plugins</groupId>

    <artifactId>maven-compiler-plugin</artifactId>

    <version>3.5.1</version>

    <configuration>

    <source>1.8</source>

    <target>1.8</target>

    <compilerArgs>

    <!-- 過期的方法的警告-->
    
    <arg>-Xlint:deprecation</arg>

    </compilerArgs>

    <compilerArguments>

    <!-- 是否輸出所有的編譯信息（包括類的加載等）-->

    <!--<verbose />-->

    <!-- 解決maven命令編譯報錯，因為rt.jar 和jce.jar在jre的lib下面，不在jdk的lib下面，

導致maven找不到（java7以后會出現這個問題），將這2個jar包拷貝到jdk的lib下面估計也好使-->

        <bootclasspath>${java.home}/lib/rt.jar;${java.home}/lib/jce.jar</bootclasspath>

    </compilerArguments>

</configuration>

</plugin>

<plugin>

    <groupId>org.springframework.boot</groupId>

    <artifactId>spring-boot-maven-plugin</artifactId>

    <executions>

        <execution>

            <goals>

                <goal>repackage</goal>

            </goals>

        </execution>

    </executions>

</plugin>        

 第二種：通過在pom.xml中指定第三方jar包路徑來引入依賴

比如第三方jar包在lib文件夾下，對pom.xml的配置如下：

<dependencies>標簽里面引入第三方jar包的依賴

pom.basedir指的是pom文件所在的目錄，

systemPath指的是第三方jar包所在路徑。

<dependency>
        <groupId>com.abc</groupId>
        <artifactId>cryptokit</artifactId>
        <version>1.0</version>
        <scope>system</scope>
        <systemPath>${pom.basedir}/lib/cryptokit-1.0.jar</systemPath>
 </dependency>

還必須修改<plugins>標簽里面的maven plugin，增加includeSystemScope屬性並設置為true

<plugin>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-maven-plugin</artifactId>
     <configuration>
           <includeSystemScope>true</includeSystemScope>
      </configuration>
</plugin>

第二種方式相比第一種方式，省事、方便。

 

2、將主程序打成jar包，然后和其他依賴jar包放在一起（包括maven下載的和第三方jar包），這樣也可以通過java -jar xxx.jar方式運行

jar方式運行的前提是主程序jar包中的META-INF文件夾下的MANIFEST.MF文件必須有正確的Class-Path、Main-Class。

Class-Path指定了主程序依賴的jar包，若配置錯誤，運行jar時將報ClassNotFoundException；若新增或刪除了一些jar包，需要刪除該文件，並重新生成。

Main-Class指定了程序的運行入口，這里配置成SpringBoot的主函數。

MANIFEST.MF文件若配置不當，運行jar時將報xxxxxx.jar中沒有主清單屬性。

MANIFEST.MF示例如下：

Manifest-Version: 1.0

Class-Path: spring-expression-4.3.20.RELEASE.jar jboss-logging-3.3.2.F

 inal.jar jcl-over-slf4j-1.7.25.jar SADK-CMBC-3.1.0.8.jar slf4j-api-1.

 7.25.jar spring-boot-starter-web-1.5.17.RELEASE.jar spring-webmvc-4.3

 .20.RELEASE.jar spring-boot-starter-tomcat-1.5.17.RELEASE.jar spring-

 aop-4.3.20.RELEASE.jar spring-boot-1.5.17.RELEASE.jar spring-boot-sta

 rter-logging-1.5.17.RELEASE.jar spring-core-4.3.20.RELEASE.jar snakey

 aml-1.17.jar tomcat-embed-websocket-8.5.34.jar spring-beans-4.3.20.RE

 LEASE.jar spring-boot-autoconfigure-1.5.17.RELEASE.jar log4j-over-slf

 4j-1.7.25.jar hibernate-validator-5.3.6.Final.jar classmate-1.3.4.jar

  spring-web-4.3.20.RELEASE.jar jul-to-slf4j-1.7.25.jar logback-classi

 c-1.1.11.jar spring-context-4.3.20.RELEASE.jar spring-boot-starter-1.

 5.17.RELEASE.jar jackson-databind-2.8.11.2.jar jackson-annotations-2.

 8.0.jar tomcat-annotations-api-8.5.34.jar tomcat-embed-el-8.5.34.jar

 jackson-core-2.8.11.jar logback-core-1.1.11.jar tomcat-embed-core-8.5

 .34.jar validation-api-1.1.0.Final.jar

Main-Class: com.example.testmaven.TestmavenApplication

3、IDEA打包步驟

3.1打包多個jar包

按Ctrl+Alt+Shift+S打開項目配置，點擊Atrifacts，然后按如下截圖進行：

 

點擊testmaven.jar，可以看到Main Class和Class Path都有內容了：

src下也生成了META-INFO文件夾和MAINFEST.MF文件：

 

構建Artifacts：

 點擊Build或者Rebuild后將在對應文件下生成artifacts文件，里面有依賴的jar包和主程序包；

 

 

文件夾地址欄輸入cmd來打開cmd：

 

 

然后輸入java -jar testmaven.jar，就能正確運行Spring Boot項目了：

 3.2 使用maven打包成一個jar包

3.2.1 使用maven工具欄打包項目

通過點擊view-tool windows -maven projects顯示maven側邊欄

 點擊maven projects側邊欄，展開Lifecycle，第一步先雙擊clean按鈕進行清理，該步會刪除之前打包的文件夾。第二步雙擊package，進行打包操作，需要等待一段時間。

 target下的紅色框圈出的就是最終的目標jar：

 

 

3.2.2 使用maven命令打包並運行項目

（1）按Alt+F12打開Terminal；

（2）輸入 mvn clean package；該命令首先清理了target文件夾，然后進行打包。等待一段時間后，打包完畢。

（3）輸入cd target 進入jar包文件夾；

  (4) 輸入java -jar xxxxx.jar 運行jar包。