配置springboot项目动静分离打包分离lib方式

更新时间：2025年02月12日 08:42:06 作者：wow_xh

本文介绍了如何将Spring Boot工程中的静态资源和配置文件分离出来,以减少jar包大小,方便修改配置文件,通过在jar包同级目录创建config目录,并在pom文件中进行相应配置,可以实现配置文件的外部化,打包后的jar包和lib文件夹中分别存放了第三方jar包和静态资源文件

前言

默认情况下，我们打包springboot工程时，会将依赖包、配置文件、静态资源和模板一起打包到jar中，这样会导致jar很大并且不容易对配置文件做出修改。

其实，经过简单的配置就可以实现静态资源的分离，做到修改文件不需要重新打包，做到业务不停，不影响已经运行的项目。

1、分离配置文件原理

springboot启动时，会优先使用同级config目录下的配置，如果没有再到包里面搜索。

这是因为 springboot 读取配置有一个优先级，放在jar包外面 config 目录优先级最高，主要是便于从外部修改配置，而不是改 jar 包中的 application.properties文件。优先级如下：

当前目录的 config 目录下
当前目录
classpath 的 config 目录下
classpath 的根目录

当application.properties和application.yml同时存在时，application.properties的优先级高于application.yml

因此，分离分配文件，只需要在jar包同级目录创建一个config目录，然后将application.properties文件放在里面就行了。

2、pom文件配置

在build标签下的plugins标签里增加以下代码

		<plugins>
            <!--定义项目的编译环境-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
            <!-- 打JAR包 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <configuration>
                    <!-- 不打包资源文件（配置文件和依赖包分开） -->
                    <excludes>
                        <exclude>*.yml</exclude>
                        <exclude>*.properties</exclude>
                        <exclude>mybatis/**</exclude>
                        <exclude>static/**</exclude>
                    </excludes>
                    <archive>
                        <manifest>
                            <addClasspath>true</addClasspath>
                            <!-- MANIFEST.MF 中 Class-Path 加入前缀 -->
                            <classpathPrefix>lib/</classpathPrefix>
                            <!-- jar包不包含唯一版本标识 -->
                            <useUniqueVersions>false</useUniqueVersions>
                            <!--指定入口类 -->
                    		<mainClass>xxxx(你的application启动文件所在位置)</mainClass>
                    		<!-- 例如<mainClass>com.ruoyi.RuoYiApplication</mainClass>-->
                        </manifest>
                        <manifestEntries>
                            <!--MANIFEST.MF 中 Class-Path 加入资源文件目录 -->
                            <Class-Path>./config/</Class-Path>
                        </manifestEntries>
                    </archive>
                    <outputDirectory>${project.build.directory}</outputDirectory>
                </configuration>
            </plugin>
            <!-- 复制项目用到的依赖jar包到lib文件夹里 -->
            <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>${project.build.directory}/lib/</outputDirectory>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

            <!-- 复制指定的文件到config文件夹里 -->
            <plugin>
                <artifactId>maven-resources-plugin</artifactId>
                <executions>
                    <execution> <!-- 复制配置文件 -->
                        <id>copy-resources</id>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-resources</goal>
                        </goals>
                        <configuration>
                            <resources>
                                <resource>
                                    <directory>src/main/resources</directory>
                                    <includes>
                                        <include>*.yml</include>
                                        <include>*.properties</include>
                                        <include>mybatis/**</include>
                                        <include>static/**</include>
                                    </includes>
                                </resource>
                            </resources>
                            <outputDirectory>${project.build.directory}/config</outputDirectory>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>

注意修改mainClass标签中的启动类文件

3、使用package命令打包

到项目的target文件夹中查看生成的文件

可以看到项目生成的jar包和原来相比已经变得很小，同时在lib文件夹里存放了项目所用到的第三方jar包，config文件夹里存放了静态资源文件和配置文件

4、总结

可以根据自己的需求自行更改代码

如果碰到plugin标签报红的情况

仍然可以进行打包，不影响package命令，如果强迫症或者打包失败，也可以导入以下依赖后刷新maven库再进行打包

        <dependency>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-dependency-plugin</artifactId>
            <version>${maven.plugins.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>${maven.plugins.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <version>${maven.plugins.version}</version>
        </dependency>

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

聊聊SpringBoot整合Nacos自动刷新配置的问题
Nacos作为SpringBoot服务的注册中心和配置中心,本例将在配置文件中配置一个 cml.age=100 的配置项，程序中编写一个方法读取配置文件，并通过 Get--->/test/age 接口提供给浏览器访问,感兴趣的朋友跟随小编一起看看吧
2022-01-01
spring学习之创建项目 Hello Spring实例代码
这篇文章主要介绍了spring学习之创建项目 Hello Spring实例代码，小编觉得还是挺不错的，具有一定借鉴价值，需要的朋友可以参考下
2018-01-01
httpclient evict操作源码解读
这篇文章主要为大家介绍了httpclient evict操作源码解读,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
2023-10-10
SpringBoot实现动态定时任务
这篇文章主要为大家详细介绍了SpringBoot实现动态定时任务，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2019-04-04
几种常见的Java运行时异常小结
在Java编程语言中异常处理是一项关键的机制,它帮助开发者识别和修复程序运行时可能出现的问题,下面这篇文章主要给大家介绍了几种常见的Java运行时异常的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
2024-08-08
Java编程中的条件判断之if语句的用法详解
这篇文章主要介绍了Java编程中的条件判断之if语句的用法详解,是Java入门学习中的基础知识,需要的朋友可以参考下
2015-11-11
Java实现根据模板读取PDF并替换指定内容
在实际开发里,经常会遇到需要根据 PDF 模板文档生成特定 PDF 的需求,本文将利用Java中的iText实现读取 PDF 模板文档并替换指定内容,最后重新生成新PDF,感兴趣的可以了解下
2025-02-02
spring boot jar的启动原理解析
这篇文章主要介绍了 spring boot jar的启动原理分析,非常不错，具有参考借鉴价值,需要的朋友可以参考下
2018-02-02
SpringBoot 之启动流程详解
SpringBoot 是一个基于 Spring 框架的快速开发框架，旨在简化 Spring 应用程序的开发和部署。在本文中，我们将深入分析 SpringBoot 启动过程的源代码，并提供必要的解释和说明
2023-04-04
使用多种方式实现遍历HashMap的方法
下面小编就为大家带来一篇使用多种方式实现遍历HashMap的方法。小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2016-05-05