SpringBoot 部署腳本進階實踐
作者：一安
在SpringBoot項目的生命周期中，Jar包部署是生產環境交付的核心環節。相比傳統WAR包部署，Jar包自帶嵌入式容器的特性讓部署流程更簡潔，但也對啟動腳本的專業性提出了更高要求。
前言
在SpringBoot項目的生命周期中，Jar包部署是生產環境交付的核心環節。相比傳統WAR包部署，Jar包自帶嵌入式容器的特性讓部署流程更簡潔，但也對啟動腳本的專業性提出了更高要求。一個健壯的啟動腳本不僅能實現服務的啟停管理，還能處理日志輪轉、內存配置、異常監控等關鍵場景，直接影響應用的穩定性與可維護性。
核心要素
SpringBoot Jar包的啟動本質上是通過java -jar命令執行主程序，但生產環境的腳本需要覆蓋更全面的場景。一個專業的啟動腳本應包含以下核心功能：
- 進程管理：實現服務的啟動、停止、重啟、狀態查詢等基礎操作，避免手動
kill進程的風險。 - 參數配置：合理設置
JVM內存參數、系統屬性、程序參數，優化應用性能。 - 日志處理：規范日志輸出路徑，實現日志輪轉，防止磁盤空間耗盡。
- 環境隔離：支持多環境配置切換，區分開發、測試、生產環境的參數差異。
- 異常防護：添加啟動前檢查、啟動超時控制、進程崩潰自動重啟等機制。
這些要素共同構成了腳本的健壯性基礎，也是從能啟動到啟動好的關鍵轉變。
腳本實現
基礎啟動
從最簡化的腳本開始，逐步構建功能完備的部署工具。
#!/bin/bash
# 應用名稱
APP_NAME="demo-service"
# Jar包路徑
JAR_FILE="./demo-service-1.0.0.jar"
# 日志輸出路徑
LOG_PATH="./logs"
# JVM參數配置
JVM_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC -Dspring.profiles.active=prod"
# 創建日志目錄
if [ ! -d "$LOG_PATH" ]; then
mkdir -p "$LOG_PATH"
fi
# 啟動函數
start() {
# 檢查進程是否已啟動
if pgrep -f "$JAR_FILE" > /dev/null; then
echo"$APP_NAME is already running."
return 1
fi
echo"Starting $APP_NAME..."
# 后臺啟動并輸出日志
nohup java $JVM_OPTS -jar $JAR_FILE --spring.config.location=./ &>/dev/null &
# 等待啟動完成
sleep 3
if pgrep -f "$JAR_FILE" > /dev/null; then
echo"$APP_NAME started successfully."
else
echo"Failed to start $APP_NAME. Check logs for details."
fi
}
# 停止函數
stop() {
if ! pgrep -f "$JAR_FILE" > /dev/null; then
echo"$APP_NAME is not running."
return 1
fi
echo"Stopping $APP_NAME..."
# 優雅停止進程
pkill -f "$JAR_FILE"
# 等待進程終止
sleep 3
if pgrep -f "$JAR_FILE" > /dev/null; then
echo"Force stopping $APP_NAME..."
pkill -9 -f "$JAR_FILE"
fi
echo"$APP_NAME stopped."
}
# 重啟函數
restart() {
stop
start
}
# 狀態查詢函數
status() {
if pgrep -f "$JAR_FILE" > /dev/null; then
echo"$APP_NAME is running."
else
echo"$APP_NAME is not running."
fi
}
# 命令分發
case"$1"in
start)
start
;;
stop)
stop
;;
restart)
restart
;;
status)
status
;;
*)
echo"Usage: $0 {start|stop|restart|status}"
exit 1
;;
esac腳本實現了最核心的進程管理功能，通過nohup實現后臺運行，使用pgrep和pkill進行進程檢測與控制，同時配置了基礎的JVM參數和日志輸出。使用時只需修改APP_NAME、JAR_FILE等變量，即可適配不同項目。
進階腳本
啟動參數優化
根據應用特性調整JVM參數，增加監控與診斷配置：
# 增強版JVM參數
JVM_OPTS="\
-Xms1024m -Xmx2048m \
-XX:+UseG1GC \
-XX:MaxGCPauseMillis=200 \
-XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m \
-XX:+HeapDumpOnOutOfMemoryError \
-XX:HeapDumpPath=$LOG_PATH/heapdump.hprof \
-XX:+PrintGCDetails \
-XX:+PrintGCDateStamps \
-Xloggc:$LOG_PATH/gc.log \
-Djava.net.preferIPv4Stack=true \
-Dfile.encoding=UTF-8 \
-Dspring.profiles.active=prod"進程 ID 管理
使用PID文件精確控制進程，避免多實例沖突：
# PID文件路徑
PID_FILE="./$APP_NAME.pid"
# 啟動函數改進
start() {
if [ -f "$PID_FILE" ] && pgrep -F "$PID_FILE" > /dev/null; then
echo"$APP_NAME is already running."
return 1
fi
echo"Starting $APP_NAME..."
rotate_logs
nohup java $JVM_OPTS -jar $JAR_FILE --spring.config.location=./ &>/dev/null &
# 寫入PID文件
echo $! > "$PID_FILE"
# ... 狀態檢查邏輯 ...
}
# 停止函數改進
stop() {
if [ ! -f "$PID_FILE" ] || ! pgrep -F "$PID_FILE" > /dev/null; then
echo"$APP_NAME is not running."
return 1
fi
echo"Stopping $APP_NAME..."
# 通過PID文件停止進程
kill $(cat "$PID_FILE")
# 等待進程終止
sleep 3
if pgrep -F "$PID_FILE" > /dev/null; then
echo"Force stopping $APP_NAME..."
kill -9 $(cat "$PID_FILE")
fi
# 刪除PID文件
rm -f "$PID_FILE"
echo"$APP_NAME stopped."
}腳本優化與擴展
配置參數外部化
將關鍵配置抽取到獨立的環境變量文件，實現配置與邏輯分離：
# 加載環境變量配置
if [ -f ".env" ]; then
source .env
else
echo "Warning: .env file not found, using default settings."
fi.env文件示例：
APP_NAME=demo-service
JAR_FILE=./demo-service-1.0.0.jar
LOG_PATH=./logs
JVM_OPTS="-Xms1024m -Xmx2048m -Dspring.profiles.active=prod"責任編輯：武曉燕
來源：
一安未來
