SpringBoot打包为外部配置包的技巧分享

 更新时间:2025年10月18日 16:45:07   作者:盹猫  
在SpringBoot开发时,在项目开发完成后,打包发布是必不可少的过程(jar,原生执行文件,dockerfile等),但打包也是有一些技巧存在的,本篇文章就是记录打包为外部配置包的技巧,需要的朋友可以参考下

前言

在SpringBoot开发时,在项目开发完成后,打包发布是必不可少的过程(jar,原生执行文件,dockerfile等),但打包也是有一些技巧存在的,面对纷繁复杂的部署环境,我们不能只会打一个jar包,更要懂得在如何部署时更方便运行和修改。

环境准备

版本

名称版本
JDK21
SpringBoot3.5.6

注:这里也可以是其它版本,不强制要求。

方法

复制配置(安装等)文件

有人可能会说了,复制文件,这有什么技巧,我直接复制不就行了(有手就行)。如果是这样,你可能有些out了,既然是用Maven命令打包jar包当然是希望在打包的过程中复制文件到目标目录了。

首先需要在pom中添加maven-resources-plugin依赖,内容如下:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-resources-plugin</artifactId>
    <version>3.3.1</version>
    <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>application.yml</include>
                            <include>application-*.yml</include>
                            <include>install.sh</include>
                        </includes>
                    </resource>
                </resources>
                <outputDirectory>${project.build.directory}</outputDirectory>
            </configuration>
        </execution>
    </executions>
</plugin>

在上述pom文件中实现的功能是:

当运行mvn pakage命令时,将src/main/resources 目录下的

  • application.yml
  • application-*.yml
  • install.sh

文件复制到目标${project.build.directory}(target)目录下。

这样再有一些其它文件需要跟随打包的jar包一起复制时,只需要修改pom文件即可。

安装服务

这里有个install.sh文件也一起复制过去的作用是:

可以快速的安装当前jar包为服务,毕竟谁也不想每次都使用java命令启动程序,这很不方便。

脚本内容如下:

#! /bin/sh

WORD_DIR=$(cd $(dirname $0); pwd)
SERVICE_NAME="cat-service"

# 检查是否为 root 用户
if [ "$(id -u)" -ne 0 ]; then
  echo "提示: 建议使用 root 用户执行此脚本,否则可能权限不足!"
  read -p "继续?(y/n) " -n 1 -r
  if [[ ! $REPLY =~ ^[Yy]$ ]]; then
    exit 1
  fi
  echo
fi

# 当前目录直接搜索(不含子目录)
jar_files=(*.jar)

if [ ${#jar_files[@]} -eq 0 ]; then
  echo "当前目录无 JAR 文件!"
  exit 1
fi

# 遍历结果
for jar in "${jar_files[@]}"; do
  echo "找到 JAR 文件: $jar"
done

# 写文件
# 生成 Systemd 服务文件内容
SERVICE_FILE="/etc/systemd/system/${SERVICE_NAME}.service"
cat << EOF | sudo tee "$SERVICE_FILE" > /dev/null
[Unit]
Description=${SERVICE_NAME}
After=syslog.target

[Service]
User=$USER
WorkingDirectory=${WORD_DIR}
ExecStart=java -jar ${jar_files}
SuccessExitStatus=143
Restart=on-failure
RestartSec=10s
Environment=SPRING_PROFILES_ACTIVE=prod

[Install]
WantedBy=multi-user.target
EOF

# 重载 Systemd 并启动服务
sudo systemctl daemon-reload
sudo systemctl enable "$SERVICE_NAME"
sudo systemctl start "$SERVICE_NAME"

# 验证服务状态
echo "服务已安装!执行以下命令查看状态:"
echo "sudo systemctl status $SERVICE_NAME"

脚本里只需要修改下服务的名称即可使用,拿来就用。

总结

这里只是举了一个简单的例子,通过使用maven-resources-plugin依赖去复制配置文件和相关自定义的快速安装程序,即可完成JAR包的外部配置和快速启动。

当然,这不是规定,你也可以自己去创建一些其它快速部署的脚本进行项目的快速部署和启动。

以上就是SpringBoot打包为外部配置包的技巧分享的详细内容,更多关于SpringBoot外部配置打包的资料请关注脚本之家其它相关文章!

相关文章

  • 最常用的1000个Java类(附代码示例)

    最常用的1000个Java类(附代码示例)

    这篇文章主要介绍了最常用的1000个Java类(附代码示例),需要的朋友可以参考下
    2015-04-04
  • Mybatis多参数及实体对象传递实例讲解

    Mybatis多参数及实体对象传递实例讲解

    在使用Mybatis的时候,经常会有各种各样的参数传递,不同类型,不同个数的参数,下面小编通过例子给大家讲解下Mybatis多参数及实体对象传递,一起看看吧
    2016-12-12
  • Admin - SpringBoot + Maven 多启动环境配置实例详解

    Admin - SpringBoot + Maven 多启动环境配置实例详解

    这篇文章主要介绍了Admin - SpringBoot + Maven 多启动环境配置,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-03-03
  • Java桥接模式实例详解【简单版与升级版】

    Java桥接模式实例详解【简单版与升级版】

    这篇文章主要介绍了Java桥接模式,结合实例形式分析了java桥接模式简单版与升级版两种实现技巧,需要的朋友可以参考下
    2019-07-07
  • Java操作数据库连接池案例讲解

    Java操作数据库连接池案例讲解

    这篇文章主要介绍了Java操作数据库连接池案例讲解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下
    2021-08-08
  • java切分字符串的2种方法实例

    java切分字符串的2种方法实例

    在我们日常工作中经常遇到截取字符串的需求,下面这篇文章主要给大家介绍了关于java切分字符串的2种方法,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2022-06-06
  • java中加密的实现方法(MD5,MD2,SHA)

    java中加密的实现方法(MD5,MD2,SHA)

    这篇文章主要介绍了java中加密的实现方法(MD5,MD2,SHA)的相关资料,这里提供三种实现加密的方法,大家可以对比一下,需要的朋友可以参考下
    2017-08-08
  • Intellij IDEA 旗舰版创建 Spring MVC 项目踩过的坑

    Intellij IDEA 旗舰版创建 Spring MVC 项目踩过的坑

    IDEA旗舰版可以直接创建Spring MVC项目,但创建后的项目并不是直接就可以运行,还需要进行一些配置。这篇文章主要介绍了Intellij IDEA 旗舰版创建 Spring MVC 项目踩坑记 ,需要的朋友可以参考下
    2020-03-03
  • SpringBoot中的server.context-path的实现

    SpringBoot中的server.context-path的实现

    本文主要介绍了SpringBoot中的server.context-path的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2024-08-08
  • Java中验证 Mybatis 数据分片可以减轻GC压力的操作方法

    Java中验证 Mybatis 数据分片可以减轻GC压力的操作方法

    这篇文章主要介绍了Java中验证 Mybatis 数据分片可以减轻GC压力的操作方法,本文使用 Spock(可集成Spring Boot项目) 编写测试用例,基于 Groovy (JVM语言),感兴趣的朋友跟随小编一起看看吧
    2024-12-12

最新评论