将SpringBoot项目部署到云服务器上：从环境准备到线上运行的完整指南

在云计算时代，将SpringBoot应用部署到云服务器已成为开发者的标准操作。本文将系统梳理部署全流程，从环境准备到线上运维，帮助开发者高效完成项目上线。

一、部署前的环境准备

1.1 云服务器选型

选择云服务器时需考虑三个核心因素：

• 实例规格：根据项目负载选择CPU/内存配置。小型应用可选2核4G，中大型应用建议4核8G起步
• 操作系统：推荐CentOS 8或Ubuntu 20.04 LTS，两者均有完善的Java运行环境支持
• 带宽配置：初期测试阶段1-2Mbps足够，正式环境建议根据并发量选择5Mbps以上

典型配置示例：

实例类型：通用型g6（4核8G）
操作系统：CentOS 8.2 64位
公网带宽：5Mbps（按流量计费）

1.2 基础环境搭建

通过SSH连接服务器后，执行以下环境配置：

# 安装OpenJDK 11
sudo yum install -y java-11-openjdk-devel
# 配置JAVA_HOME环境变量
echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk' >> ~/.bashrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
# 安装Maven构建工具
sudo wget https://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.8.4/binaries/apache-maven-3.8.4-bin.tar.gz
sudo tar -zxvf apache-maven-3.8.4-bin.tar.gz -C /opt
echo 'export MAVEN_HOME=/opt/apache-maven-3.8.4' >> ~/.bashrc
echo 'export PATH=$MAVEN_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

二、项目打包与传输

2.1 构建可执行JAR包

在项目根目录执行Maven打包命令：

mvn clean package -Dmaven.test.skip=true

生成的JAR包位于target/目录下，建议重命名为包含版本号的格式：

mv target/your-app-0.0.1-SNAPSHOT.jar target/your-app-1.0.0.jar

2.2 文件传输方案

推荐使用以下三种传输方式：

1. SCP命令传输：

   scp target/your-app-1.0.0.jar username@server_ip:/opt/apps/

2. SFTP工具传输：使用FileZilla等工具可视化上传

3. Git部署方案（适合持续部署）：

   git clone your-repo.git
   cd your-repo
   mvn package

三、服务器端部署配置

3.1 运行环境优化

创建专用用户并设置权限：

sudo useradd -m appuser
sudo chown -R appuser:appuser /opt/apps/

配置JVM参数（根据服务器内存调整）：

JAVA_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC"

3.2 启动脚本示例

创建/opt/apps/start.sh脚本：

#!/bin/bash
APP_NAME="your-app-1.0.0.jar"
LOG_FILE="/var/log/springboot-app.log"
nohup java $JAVA_OPTS -jar /opt/apps/$APP_NAME > $LOG_FILE 2>&1 &
echo "Application started with PID $!"

设置执行权限并启动：

chmod +x /opt/apps/start.sh
/opt/apps/start.sh

四、生产环境优化方案

4.1 进程管理配置

使用systemd管理应用进程（推荐方案）：
创建/etc/systemd/system/springboot.service：

[Unit]
Description=SpringBoot Application
After=syslog.target network.target
[Service]
User=appuser
WorkingDirectory=/opt/apps
ExecStart=/usr/bin/java $JAVA_OPTS -jar /opt/apps/your-app-1.0.0.jar
SuccessExitStatus=143
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target

启用服务：

sudo systemctl daemon-reload
sudo systemctl enable springboot
sudo systemctl start springboot

4.2 日志管理方案

配置logback-spring.xml实现日志分割：

<configuration>
    <appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>/var/log/springboot-app.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>/var/log/springboot-app-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxFileSize>10MB</maxFileSize>
            <maxHistory>30</maxHistory>
            <totalSizeCap>1GB</totalSizeCap>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <root level="INFO">
        <appender-ref ref="ROLLING"/>
    </root>
</configuration>

五、安全与运维配置

5.1 防火墙设置

开放必要端口并限制访问：

sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --permanent --add-port=22/tcp --set-target=ACCEPT
sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="192.168.1.0/24" port protocol="tcp" port="22" accept'
sudo firewall-cmd --reload

5.2 监控方案

配置Prometheus监控（示例配置）：

# prometheus.yml
scrape_configs:
  - job_name: 'springboot-app'
    metrics_path: '/actuator/prometheus'
    static_configs:
      - targets: ['your-server-ip:8080']

在SpringBoot应用中添加依赖：

<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-registry-prometheus</artifactId>
</dependency>

六、常见问题解决方案

6.1 端口冲突处理

检查端口占用并终止进程：

sudo netstat -tulnp | grep 8080
sudo kill -9 <PID>

6.2 内存溢出处理

分析heap dump文件：

# 启动时添加参数
JAVA_OPTS="-Xms512m -Xmx1024m -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/log/"
# 分析工具
sudo yum install -y graphviz
java -jar /opt/eclipse-memoryanalyzer/mat.jar /var/log/java_pid<PID>.hprof

6.3 数据库连接问题

检查数据源配置并验证网络连通性：

# application.yml
spring:
  datasource:
    url: jdbc:mysql://db-server:3306/yourdb?useSSL=false
    username: dbuser
    password: securepassword
    hikari:
      connection-timeout: 30000
      maximum-pool-size: 10

七、持续部署建议

1. 蓝绿部署：准备两套完全相同的环境，通过负载均衡切换
2. 金丝雀发布：先向少量用户推送新版本，观察指标后再全量发布
3. 自动化流水线：

   # GitLab CI示例
   deploy_production:
     stage: deploy
     script:
       - ssh user@server "cd /opt/apps && ./stop.sh"
       - scp target/your-app-*.jar user@server:/opt/apps/
       - ssh user@server "cd /opt/apps && ./start.sh"
     only:
       - master

通过以上系统化的部署方案，开发者可以高效完成SpringBoot项目的云服务器部署。实际部署时，建议先在测试环境验证完整流程，再执行生产环境部署。定期检查日志和监控指标，建立完善的告警机制，确保应用稳定运行。