快捷導(dǎo)航

配置springboot項目動靜分離打包分離lib方式

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

本文介紹了如何將Spring?Boot工程中的靜態(tài)資源和配置文件分離出來,以減少jar包大小,方便修改配置文件,通過在jar包同級目錄創(chuàng)建config目錄,并在pom文件中進(jìn)行相應(yīng)配置,可以實現(xiàn)配置文件的外部化,打包后的jar包和lib文件夾中分別存放了第三方j(luò)ar包和靜態(tài)資源文件

前言

默認(rèn)情況下，我們打包springboot工程時，會將依賴包、配置文件、靜態(tài)資源和模板一起打包到j(luò)ar中，這樣會導(dǎo)致jar很大并且不容易對配置文件做出修改。

其實，經(jīng)過簡單的配置就可以實現(xiàn)靜態(tài)資源的分離，做到修改文件不需要重新打包，做到業(yè)務(wù)不停，不影響已經(jīng)運行的項目。

1、分離配置文件原理

springboot啟動時，會優(yōu)先使用同級config目錄下的配置，如果沒有再到包里面搜索。

這是因為 springboot 讀取配置有一個優(yōu)先級，放在jar包外面 config 目錄優(yōu)先級最高，主要是便于從外部修改配置，而不是改 jar 包中的 application.properties文件。優(yōu)先級如下：

當(dāng)前目錄的 config 目錄下
當(dāng)前目錄
classpath 的 config 目錄下
classpath 的根目錄

當(dāng)application.properties和application.yml同時存在時，application.properties的優(yōu)先級高于application.yml

因此，分離分配文件，只需要在jar包同級目錄創(chuàng)建一個config目錄，然后將application.properties文件放在里面就行了。

2、pom文件配置

在build標(biāo)簽下的plugins標(biāo)簽里增加以下代碼

		<plugins>
            <!--定義項目的編譯環(huán)境-->
            <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包不包含唯一版本標(biāo)識 -->
                            <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>
            <!-- 復(fù)制項目用到的依賴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>

            <!-- 復(fù)制指定的文件到config文件夾里 -->
            <plugin>
                <artifactId>maven-resources-plugin</artifactId>
                <executions>
                    <execution> <!-- 復(fù)制配置文件 -->
                        <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標(biāo)簽中的啟動類文件

3、使用package命令打包

到項目的target文件夾中查看生成的文件

可以看到項目生成的jar包和原來相比已經(jīng)變得很小，同時在lib文件夾里存放了項目所用到的第三方j(luò)ar包，config文件夾里存放了靜態(tài)資源文件和配置文件

4、總結(jié)

可以根據(jù)自己的需求自行更改代碼

如果碰到plugin標(biāo)簽報紅的情況

仍然可以進(jìn)行打包，不影響package命令，如果強迫癥或者打包失敗，也可以導(dǎo)入以下依賴后刷新maven庫再進(jìn)行打包

        <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>

以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。

您可能感興趣的文章: