SpringBoot项目部署之启动脚本

一、启动脚本方案

1. 基础启动方式

1.1 直接运行JAR

java -jar your-app.jar --spring.profiles.active=prod

• 优点：简单直接，适合快速测试
• 缺点：终端关闭即终止进程

1.2 后台运行

nohup java -jar your-app.jar > app.log 2>&1 &

• 参数说明：
  • nohup：忽略挂断信号，后台运行
  • > app.log：标准输出重定向
  • 2>&1：错误输出重定向
  • &：后台运行

2. Shell脚本封装

start.sh

#!/bin/bash# 使用参数传入 JAR 文件名和应用名称
JAR_NAME=wkl-business.jar
APP_NAME=wkl-business# 启动命令（保留原逻辑）
nohup java -jar -Dfile.encoding=UTF-8 $JAR_NAME $APP_NAME &
echo "Started $APP_NAME with command: java -jar $JAR_NAME $APP_NAME"

---

二、关闭脚本方案

1. 基础关闭方式

# 通过进程ID关闭
kill $(lsof -t -i:8080)# 强制终止
kill -9 <PID>

2. Shell脚本封装

stop.sh

#!/bin/bash# 使用参数传入应用名称
APP_NAME=wkl-business# 原停止逻辑（仅提取 PID 方式）
pid=$(ps ax | grep -i "$APP_NAME" | grep java | grep -v grep | awk '{print $1}')
if [ -z "$pid" ]; thenecho "No $APP_NAME running."exit -1
fiecho "The $APP_NAME ($pid) is running..."
kill $pid
echo "Send shutdown request to $APP_NAME ($pid) OK"

---

三、完整示例脚本1

• jar包同级目录下创建logs文件夹
• 注：记得给脚本增加权限：chmod 777 start.sh、chmod 777 stop.sh
• 脚本如下：

start.sh

#!/bin/bash
BASEPATH=$(cd "$(dirname "$0")"; pwd)
APP_NAME="demo.jar"
JAR_PATH=$BASEPATH/$APP_NAME
LOG_DIR=$BASEPATH/logs/${APP_NAME%.*}/nohup.out  # 日志路径示例
PID_FILE=$BASEPATH/$APP_NAME.pid
JAVA_OPTS="-Xms1g -Xmx2g -Dspring.profiles.active=prod"# 创建日志目录
mkdir -p $(dirname $LOG_DIR)# 检查运行状态
if [ -f "$PID_FILE" ]; thenPID=$(cat "$PID_FILE")if ps -p $PID > /dev/null 2>&1; thenecho "Application is already running with PID: $PID. Exiting..."exit 1elseecho "PID file exists but process not found. Cleaning up..."rm -f "$PID_FILE"fi
fi# 启动应用
nohup java $JAVA_OPTS -jar "$JAR_PATH" >> "$LOG_DIR" 2>&1 &# 记录进程ID
echo $! > "$PID_FILE"
echo "Application started with PID: $(cat "$PID_FILE")"# 查看日志
tail -100f "$LOG_DIR"

stop.sh

#!/bin/bash
BASEPATH=$(cd "$(dirname "$0")"; pwd)
APP_NAME="demo.jar"
PID_FILE="$BASEPATH/$APP_NAME.pid"if [ -f "$PID_FILE" ]; thenPID=$(cat "$PID_FILE")# 验证进程是否存在且为 Java 进程if ps -p "$PID" > /dev/null 2>&1 && [[ "$(ps -p "$PID" -o comm=)" == *"java"* ]]; thenecho "Stopping application with PID: $PID..."kill -15 "$PID"# 等待进程终止（最多30秒）for i in {1..30}; doif ! ps -p "$PID" > /dev/null 2>&1; thenbreakfisleep 1done# 强制终止（如果仍存在）if ps -p "$PID" > /dev/null 2>&1; thenecho "Force killing PID: $PID..."kill -9 "$PID"sleep 1fielseecho "PID $PID is invalid. Cleaning up..."fi# 清理 PID 文件rm -f "$PID_FILE"
elseecho "PID file not found. Application is not running."
fiecho "Application stopped"

---

四、完整示例脚本2

• jar包同级目录下创建logs文件夹
• jar包同级目录下创建config文件夹，包含application.yml 和logback.xml (非必须)文件，给777权限
• 脚本如下：

# 该脚本为Linux下启动java程序的脚本
# 特别注意：
# 该脚本使用系统kill命令来强制终止指定的java程序进程。
# 所以在杀死进程前，可能会造成数据丢失或数据不完整。如果必须要考虑到这类情况，则需要改写此脚本，
# 
# 根据实际情况来修改以下配置信息 ################################### JAVA应用程序的名称
APP_NAME=xxxx系统
#获取脚本所在目录的绝对路径。
BASEPATH=$(cd "$(dirname "$0")"; pwd)
# jar包名称-记得更改
JAR_NAME=demo.jar
# PID 代表是PID文件（改进：使用绝对路径避免目录混乱）
JAR_PID="$BASEPATH/$JAR_NAME.pid"
# java虚拟机启动参数
JAVA_OPTS="-Xms512m -Xmx2048m -XX:MetaspaceSize=512m -XX:MaxMetaspaceSize=512m -XX:ParallelGCThreads=16 -XX:+PrintGCDateStamps -XX:+PrintGCDetails -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=utf-8"
LOG_DIR="$BASEPATH/logs"# 根据实际情况来修改以上配置信息 ################################### ######### Shell脚本中$0、$?、$!、$$、$*、$#、$@等的说明 #########
# $$ Shell本身的PID（ProcessID，即脚本运行的当前 进程ID号）
# $! Shell最后运行的后台Process的PID(后台运行的最后一个进程的 进程ID号)
# $? 最后运行的命令的结束代码（返回值）即执行上一个指令的返回值 (显示最后命令的退出状态。0表示没有错误，其他任何值表明有错误)
# $- 显示shell使用的当前选项，与set命令功能相同
# $* 所有参数列表。如"$*"用「"」括起来的情况、以"$1 $2 … $n"的形式输出所有参数，此选项参数可超过9个。
# $@ 所有参数列表。如"$@"用「"」括起来的情况、以"$1" "$2" … "$n" 的形式输出所有参数。
# $# 添加到Shell的参数个数
# $0 Shell本身的文件名
# $1～$n 添加到Shell的各参数值。$1是第1参数、$2是第2参数…。
# ######### 说明结束 ########## 检查程序是否处于运行状态（改进：使用pgrep精确匹配进程）
is_exist() {# 改进：使用pgrep替代ps/grep组合，避免误判pid=$(pgrep -f "$JAR_NAME" | grep -v "$$")  # 排除当前脚本进程if [ -n "$pid" ]; thenreturn 0  # 存在返回0（符合Shell习惯）elsereturn 1  # 不存在返回1fi
}# 服务启动方法
start() {is_existif [ $? -eq 0 ]; thenecho "$APP_NAME is already running (PID: $(cat "$JAR_PID"))"return 1fi# 创建日志目录（原脚本未处理）# jar服务启动脚本（改进：验证启动是否成功）nohup java $JAVA_OPTS -jar -Dlogging.config=./config/logback.xml "$BASEPATH/$JAR_NAME" >> "$LOG_DIR/nohup.out" 2>&1 &pid=$!# 验证进程是否存活再记录PIDif ps -p $pid > /dev/null 2>&1; thenecho "$pid" > "$JAR_PID"echo "Start success, PID: $pid"tail -100f "$LOG_DIR/nohup.out"elseecho "Failed to start $APP_NAME"exit 1fi
}# 服务停止方法（改进：优雅终止+超时处理）
stop() {if [ ! -f "$JAR_PID" ]; thenecho "PID file not found. Application is not running."return 1fipid=$(cat "$JAR_PID")# 验证PID有效性if ! ps -p $pid > /dev/null 2>&1; thenecho "Process $pid does not exist. Cleaning up."rm -f "$JAR_PID"return 1fi# 优雅终止（SIGTERM）echo "Stopping $APP_NAME (PID: $pid)..."kill $pid# 等待最多30秒for i in {1..30}; doif ! ps -p $pid > /dev/null 2>&1; thenrm -f "$JAR_PID"echo "Stopped gracefully."return 0fisleep 1done# 超时后强制终止（SIGKILL）echo "Force-stopping $APP_NAME..."kill -9 $pidsleep 1if ps -p $pid > /dev/null 2>&1; thenecho "Failed to stop $APP_NAME."return 1elserm -f "$JAR_PID"echo "Force-stopped."return 0fi
}# 服务运行状态查看方法
status() {is_existif [ $? -eq 0 ]; thenecho "$APP_NAME is running (PID: $(cat "$JAR_PID"))"elseecho "$APP_NAME is not running"fi
}# 重启服务方法
restart() {stop && start
}# 帮助说明，用于提示输入参数信息
usage() {echo "Usage: sh $0 {start|stop|restart|status}"exit 1
}###################################
# 读取脚本的第一个参数($1)，进行判断
# 参数取值范围：{ start | stop | restart | status }
# 如参数不在指定范围之内，则打印帮助信息
###################################
case "$1" instart)start;;stop)stop;;restart)restart;;status)status;;*)usage;;
esac
exit 0

---

五、注意事项

1. 端口冲突处理：

   # 检查端口占用
   lsof -i :8080
   

2. 内存配置优化：

   • 根据服务器配置调整-Xms和-Xmx
   • 启用G1垃圾回收器：-XX:+UseG1GC

3. 服务监控：

   • 集成Prometheus监控
   • 配置邮件/SMS告警

4. 滚动更新策略：

   • 使用蓝绿部署
   • 配置Kubernetes滚动更新策略