背景

之前在部署Spring Boot项目时，经常因为只修改了一小处代码、或者只更新了某个jar包，但是却需要将整个项目重新打包、上传、部署，整个包一般都会达到40-60M，每次都重复这个操作真的很耗费时间，因此就想是否能够将依赖lib与项目代码分离出来，每次部署只需要发布代码即可。

尝试

参考了一些文章并进行了试验，发现总是有这样或那样的问题。主要尝试了2种常见的方式：
1）maven-jar-plugin + maven-assembly-plugin
2）spring-boot-maven-plugin 　+　maven-dependency-plugin　＋　maven-resources-plugin

第1种方式，不使用spring-boot-maven-plugin插件进行打包，而是使用maven-jar-plugin打包成可执行jar包。
结果：这个方式的确可以生成llb、bin、config、xx.jar等目录结构，jar包也可以执行，
问题：但是却会提示 “Unable to resolve persistence unit root URL”，这是因为项目中引入了spring-boot-starter-data-jpa依赖。
网上说去掉该依赖就可以，但是对于这个项目却是必须使用到该依赖。

第2种方式，会在target/目录下生成lib目录，以及单独的项目jar包。程序可以正确执行。
但是目录结构比较散乱，散放在target目录中，最终还需要手动拷贝lib和jar包。不是我想要的方式，我想要将所有打包后的结果单独存在一个zip包中。
研究了下，发现使用spring-boot-maven-plugin打包出来的jar包中，包含的manifest.mf文件与使用maven-jar-plugin 打包的有些差别，

Manifest-Version: 1.0
Implementation-Title: MyTest
Implementation-Version: 0.0.2
Built-By: JinPinTech
Implementation-Vendor-Id: my.test
Spring-Boot-Version: 2.1.4.RELEASE
Main-Class: org.springframework.boot.loader.PropertiesLauncher
Start-Class: my.test.SpringBootApplication
Spring-Boot-Classes: BOOT-INF/classes/
Spring-Boot-Lib: BOOT-INF/lib/
Created-By: Apache Maven 3.3.9
Build-Jdk: 1.8.0_131
Implementation-URL: https://projects.spring.io/spring-boot/#/spring-boot-starter-parent/mytest

多了较多Spring-boot的配置信息，其中最主要的是Main-Class是org.springframework.boot.loader.PropertiesLauncher，而非SpringBoot的Appliction启动类。启动类放在了Start-Class。
由此想到，使用第1种方式一直报错缺少依赖，应该就是maven-jar-plugin缺少了对spring-boot-starter-data-jpa的支持。

解决

因此便想到一个新的解决方案——综合以上两种方式的优点：spring-boot-maven-plugin + maven-assembly-plugin。
1）使用spring-boot-maven-plugin，可以解决前面提到的缺少spring-boot-starter-data-jpa依赖的问题，保证jar包可以正确执行。
2）使用maven-assembly-plugin，可以非常灵活的自定义打包配置，生成干净清晰的目录结构。

经试验，果真成功，程序可以正确运行，目录结构也能自定义设置。完美！

打包后的目录结构

以下就贴上我的配置方式：

1. 修改pom.xml，添加插件

   <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <layout>ZIP</layout>
                    <includes>
                        <include>
                            <groupId>my.test</groupId>
                            <artifactId>MyTest</artifactId>
                        </include>
                    </includes>
                </configuration>
            </plugin>
            <!-- 使用assembly打包 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-assembly-plugin</artifactId>
                <configuration>
                    <descriptors>
                        <!-- assembly配置文件位置 -->
                        <descriptor>src/main/assembly/assembly.xml</descriptor>
                    </descriptors>
                </configuration>
                <executions>
                    <execution>
                        <id>make-assembly</id>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

<!-- 打包发布时，跳过单元测试 -->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <configuration>
        <skipTests>true</skipTests>
    </configuration>
</plugin>

2. 在 src/main目录建立assembly目录，添加assembly.xml

<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2
       http://maven.apache.org/xsd/assembly-1.1.2.xsd">
    <!--
        必须写，否则打包时会有 assembly ID must be present and non-empty 错误
        这个名字最终会追加到打包的名字的末尾，如项目的名字为 speed-api-0.0.1-SNAPSHOT,
        则最终生成的包名为 speed-api-0.0.1-SNAPSHOT-bin.zip
     -->
    <id>bin</id>

    <!-- 打包后的文件格式,可以是zip,tar,tar.gz,tar.bz2,jar,war,dir -->
    <formats>
        <format>zip</format>
    </formats>

    <!-- 压缩包下是否生成和项目名相同的根目录 -->
    <includeBaseDirectory>false</includeBaseDirectory>

    <dependencySets>
        <dependencySet>
            <!-- 不使用项目的artifact，第三方jar不要解压，打包进zip文件的lib目录 -->
            <useProjectArtifact>false</useProjectArtifact>
            <outputDirectory>lib</outputDirectory>
            <unpack>false</unpack>
            <!-- 将scope为runtime的依赖包打包到lib目录下。 -->
            <scope>runtime</scope>
        </dependencySet>
    </dependencySets>

    <fileSets>
        <!-- 把项目相关的说明文件，打包进zip文件的根目录 -->
        <fileSet>
            <directory>${project.basedir}</directory>
            <outputDirectory></outputDirectory>
            <includes>
                <include>README*</include>
                <include>LICENSE*</include>
                <include>NOTICE*</include>
            </includes>
        </fileSet>

        <!-- 把项目的配置文件，打包进zip文件的config目录 -->
        <fileSet>
            <directory>${project.basedir}/src/main/resources</directory>
            <outputDirectory>config</outputDirectory>
            <excludes>
            <exclude>test</exclude>
            <exclude>test/*</exclude>
            <exclude>*.properties</exclude>
            </excludes>
        </fileSet>

        <!-- 把项目的脚本文件，打包进zip文件的bin目录 -->
        <fileSet>
            <directory>${project.basedir}/src/main/bin</directory>
            <outputDirectory></outputDirectory>
        </fileSet>

        <!-- 把项目自己编译出来的jar文件，打包进zip文件的根目录 -->
        <fileSet>
            <directory>${project.build.directory}</directory>
            <outputDirectory></outputDirectory>
            <includes>
                <include>*.jar</include>
            </includes>
        </fileSet>
    </fileSets>
</assembly>

启动

java -Dloader.path=lib/ -jar MyTest.jar

附录

1. 方式一：

<plugins>
<!-- 指定启动类，将依赖打成外部jar包 -->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <configuration>
        <archive>
            <!-- 生成的jar中，不要包含pom.xml和pom.properties这两个文件 -->
            <addMavenDescriptor>false</addMavenDescriptor>
            <manifest>
                <!-- 是否要把第三方jar放到manifest的classpath中 -->
                <addClasspath>true</addClasspath>
                <!-- 外部依赖jar包的最终位置 -->
                <classpathPrefix>lib/</classpathPrefix>
                <!-- 项目启动类 -->
                <mainClass>${main.class}</mainClass>
            </manifest>
        </archive>
    </configuration>
</plugin>

<!-- 使用assembly打包 -->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-assembly-plugin</artifactId>
    <configuration>
        <descriptors>
            <!-- assembly配置文件位置 -->
            <descriptor>src/main/assembly/assembly.xml</descriptor>
        </descriptors>
    </configuration>
    <executions>
        <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
                <goal>single</goal>
            </goals>
        </execution>
    </executions>
</plugin>
</plugins>

2. 方式二
   参考了简书作者小红牛的《Springboot 打jar包分离lib，配置文件正确方式》的文章，以下为文章中的配置信息。

 <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-dependency-plugin</artifactId>
                <executions>
                    <execution>
                        <id>copy-dependencies</id>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-dependencies</goal>
                        </goals>
                        <configuration>
                            <outputDirectory>target/lib</outputDirectory>
                            <excludeTransitive>false</excludeTransitive>
                            <stripVersion>false</stripVersion>
                            <includeScope>runtime</includeScope>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <layout>ZIP</layout>
                    <includes>
                        <include>
                            <groupId>cn.jstars</groupId>
                            <artifactId>datatocloud</artifactId>
                        </include>
                    </includes>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-resources-plugin</artifactId>
                <configuration>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <configuration>
                    <skip>true</skip>
                </configuration>
            </plugin>
        </plugins>
        <resources>
            <resource>
                <filtering>true</filtering>
                <directory>src/main/resources</directory>
                <excludes>
                    <exclude>static/**</exclude>
                    <exclude>templates/**</exclude>
                    <exclude>*.yml</exclude>
                    <exclude>*.properties</exclude>
                    <exclude>*.xml</exclude>
                    <exclude>*.txt</exclude>
                </excludes>
            </resource>
        </resources>
    </build>