香港服务器部署Spring Boot应用,生产上线前要准备什么

发布人:A5数据发布时间:2026-11-08 14:04阅读量:88

生产上线前,香港服务器上的 Spring Boot 应用不应只满足“java -jar 能启动”。更稳妥的目标状态是:应用由 systemd 托管,公网请求只通过 Nginx 的 80/443 入口进入,应用端口仅监听本机,日志有留存边界,证书和 DNS 可验证,发布包与上一版本可以快速切换。

这类变更的主要风险通常不在启动命令本身,而在入口配置、数据库兼容性、密钥加载、端口暴露、跨区域依赖和回滚条件没有提前确认。下面以 Ubuntu 22.04/24.04、systemd、Nginx、JDK 17 或 JDK 21 为例,按“现状核对—准备—实施—验证—回滚”的顺序执行。实际环境中的 Spring Boot 版本、JDK 版本和服务名称应以现有项目为准。

Spring Boot生产部署所需的计算、存储与网络资源,A5idc数据提供香港物理服务器方案,涵盖Xeon Gold、AMD EPYC等平台,并有SSD或NVMe存储及CN2、国际带宽等不同配置方向,可用于企业网站、业务后台、数据库和接口服务。对于面向不同地区用户或负载形态各异的应用,也可结合美国、日本、新加坡等地区的服务器资源,构建与业务部署区域相匹配的硬件基础。

一、先核对当前状态和影响范围

1. 确认运行环境与版本关系

Spring Boot 3.x 通常使用 JDK 17 及以上版本,Spring Boot 2.7 可以运行在多个 JDK 版本上,但仍应以项目构建配置为准。不要因为服务器已经安装了某个 JDK,就直接用它启动生产包。

先在服务器上记录当前状态:

java -version
uname -a
systemctl --version | head -n 1
nginx -v
timedatectl

如果应用已经运行,还需要确认服务名、进程、监听端口和工作目录:

systemctl list-units --type=service --all | grep -Ei 'spring|java|myapp'
ps -ef | grep '[j]ava'
ss -lntp

重点核对以下内容:

核对项需要确认的内容验收标准
JDK构建时 JDK 与运行时 JDK主版本兼容,java -version 可追溯
服务管理是否已有同名 systemd 服务不重复创建多个启动入口
监听端口Spring Boot 当前端口例如仅监听 127.0.0.1:8080
Nginx当前站点配置与证书路径修改前已保存配置副本
数据库地址、账号权限、连接池和迁移状态发布包与数据库结构兼容
磁盘与内存当前使用量和可用空间有足够空间保存新旧版本及日志
时间时区、NTP 同步状态应用、数据库、日志时间口径一致

资源检查可以使用:

free -h
df -hT
df -ih
uptime

2. 核对香港服务器相关的网络依赖

服务器位于香港,并不意味着所有依赖都在同一网络区域。生产变更前应单独检查:

  • 数据库、对象存储、支付接口或第三方 API 是否按源 IP 放行;
  • 外部服务白名单中是否已加入香港服务器的公网出口 IP;
  • DNS 的 A 记录是否指向新服务器,是否存在仍指向旧地址的 AAAA 记录;
  • 云厂商安全组与服务器本机防火墙是否同时放行了 80、443;
  • 应用访问跨区域数据库时,连接建立、查询耗时和连接池参数是否仍可接受;
  • 服务器时区是否统一使用 UTC,或按业务要求使用 Asia/Hong_Kong。

可以从服务器直接检查 DNS 和外部依赖:

dig +short example.com A
dig +short example.com AAAA
curl -sS -o /dev/null -w 'status=%{http_code} time=%{time_total}s\n' https://依赖服务.example.com/health

如果服务器没有配置 IPv6,而域名存在错误的 AAAA 记录,部分客户端可能优先访问 IPv6,造成“有些地区可以访问、有些地区超时”的现象。这个问题应在切换 DNS 前处理,而不是上线后再排查。

3. 明确本次变更的影响边界

在变更单或内部记录中,至少写清楚以下范围:

  • 只替换 Spring Boot 应用包,还是同时修改数据库结构;
  • 是否会重启应用,预计中断多长时间;
  • 是否修改 Nginx、证书、DNS 或防火墙;
  • 是否会改变外部回调地址、源 IP 或请求路径;
  • 旧版本、旧配置和数据库备份是否可恢复。

应用包、Nginx 和 DNS 可以分阶段处理。数据库结构变更应尽量与应用发布拆开;如果必须同时变更,先确认新旧版本在一段时间内都能兼容,避免应用回滚后无法读取已经升级的数据结构。

二、上线前准备可回退的发布材料

1. 固定发布包和配置版本

不要直接覆盖 /opt/myapp/app.jar。建议按版本或时间建立发布目录,并保留上一版本:

/opt/myapp/
├── current -> /opt/myapp/releases/20250308-01
└── releases/
    ├── 20250301-02/
    │   └── app.jar
    └── 20250308-01/
        └── app.jar

发布包应来自已完成构建和测试的流水线。上传到服务器后校验摘要:

sha256sum app.jar
sha256sum -c app.jar.sha256

app.jar.sha256 应由构建环境生成,不能在文件损坏后才在服务器上重新计算并把结果当成校验依据。发布包、启动参数和配置文件需要记录对应版本,便于之后判断“运行的到底是哪一版”。

2. 备份现有配置和服务定义

如果当前应用已经在线,先备份 systemd 和 Nginx 配置。下面的命令只复制文件,不会修改运行中的服务:

sudo cp -a /etc/systemd/system/myapp.service \
  /etc/systemd/system/myapp.service.bak.$(date +%Y%m%d%H%M%S)

sudo cp -a /etc/nginx/sites-available/myapp \
  /etc/nginx/sites-available/myapp.bak.$(date +%Y%m%d%H%M%S)

如果文件路径不同,应先通过以下命令确认实际路径:

systemctl cat myapp
nginx -T

生产配置中的数据库密码、签名密钥和第三方凭证不应写进 Git 仓库,也不要直接粘贴到工单或聊天记录。可以单独放在权限受控的环境文件中,例如:

sudo install -d -m 0750 -o root -g myapp /etc/myapp
sudo touch /etc/myapp/myapp.env
sudo chown root:myapp /etc/myapp/myapp.env
sudo chmod 0640 /etc/myapp/myapp.env

环境文件示例:

SPRING_PROFILES_ACTIVE=prod
SERVER_PORT=8080
JAVA_TOOL_OPTIONS=-Xms512m -Xmx2048m -XX:+ExitOnOutOfMemoryError -XX:HeapDumpPath=/var/lib/myapp
SPRING_DATASOURCE_URL=jdbc:mysql://db.example.com:3306/app?useUnicode=true&characterEncoding=utf8
SPRING_DATASOURCE_USERNAME=app_user
SPRING_DATASOURCE_PASSWORD=请替换为实际密钥

上面的 Xmx2048m 只适合特定资源规模的示例。若服务器只有 2 GB 内存,不能照搬该值;需要为操作系统、Nginx、监控程序和文件缓存预留内存。一个 4 GB 服务器可以先将 Java 堆上限设置在约 2 GB 附近,再根据 GC、堆外内存和业务峰值调整,而不是把全部内存分配给 JVM。

3. 准备日志、健康检查和数据库条件

生产环境至少应能回答三个问题:

  1. 应用当前是否存活;
  2. 应用是否已经可以接受业务流量;
  3. 应用异常时,能否定位到启动错误、数据库错误或外部接口错误。

如果使用 Spring Boot Actuator,可以在生产配置中只暴露必要的健康检查端点。以 Spring Boot 2.6+/3.x 为例:

server:
  address: 127.0.0.1
  port: ${SERVER_PORT:8080}
  forward-headers-strategy: framework

management:
  endpoints:
    web:
      exposure:
        include: health
  endpoint:
    health:
      probes:
        enabled: true

server.address: 127.0.0.1 可以避免应用端口直接暴露到公网。Actuator 端点也不应未经限制就对外开放,外部访问应通过业务入口或独立监控策略处理。

数据库方面,发布前应确认:

  • 生产数据库已有可用备份,且恢复方式经过验证;
  • 新版本需要的表、字段、索引已准备完成;
  • 数据库账号权限没有在发布过程中临时扩大;
  • 连接池上限不会超过数据库允许的连接数;
  • 旧版本是否仍能读取新版本写入的数据。

如果数据库迁移不可逆,不能把“切回旧 JAR”当作完整回滚方案。此时应优先设计向前修复脚本,或按照数据库备份恢复方案处理。

三、按低风险顺序实施变更

1. 上传新版本但暂不切换流量

先确认运行用户是否存在:

id myapp

如果项目已有专用用户,继续使用原用户,不要临时改成 root。在确认目录结构后创建新版本目录:

sudo install -d -o myapp -g myapp /opt/myapp/releases/20250308-01
sudo install -d -o myapp -g myapp /var/lib/myapp
sudo install -o myapp -g myapp -m 0644 app.jar \
  /opt/myapp/releases/20250308-01/app.jar

检查新包和旧包是否都存在:

ls -lh /opt/myapp/releases/20250308-01/app.jar
readlink -f /opt/myapp/current

如果 /opt/myapp/current 当前已经是软链接,可以在确认旧目标路径后进行切换。若它是实际目录,不要直接覆盖,应先备份并调整目录方案。

2. 让 systemd 接管应用进程

服务定义可以放在 /etc/systemd/system/myapp.service:

[Unit]
Description=Spring Boot application
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=myapp
Group=myapp
WorkingDirectory=/opt/myapp
EnvironmentFile=/etc/myapp/myapp.env
ExecStart=/usr/bin/java -jar /opt/myapp/current/app.jar
SuccessExitStatus=143
Restart=on-failure
RestartSec=5
TimeoutStopSec=30
NoNewPrivileges=true
PrivateTmp=true
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

执行前检查 Java 路径:

command -v java
readlink -f "$(command -v java)"

如果实际路径不是 /usr/bin/java,应修改 ExecStart,不要凭经验填写。应用服务使用标准输出和标准错误时,可以直接通过 journald 查看:

sudo systemctl daemon-reload
sudo systemctl enable myapp

新服务首次启动使用:

sudo systemctl start myapp

已有服务切换版本使用:

sudo systemctl restart myapp

重启前应确认当前业务允许短暂中断。若需要更低中断时间,应采用双实例或负载均衡方案,而不是在单实例上连续重启多次。

3. 用软链接切换发布版本

切换前再次记录当前版本:

readlink -f /opt/myapp/current

确认新包已经上传、配置文件可读、数据库兼容后,再切换软链接:

sudo ln -sfnT /opt/myapp/releases/20250308-01 /opt/myapp/current
sudo systemctl restart myapp

ln -sfnT 的目标应是发布软链接,不应指向包含重要数据的实际目录。切换完成后立即检查:

systemctl is-active myapp
systemctl show myapp --property=MainPID,ExecMainStartTimestamp,NRestarts

4. 配置 Nginx 作为唯一公网入口

Nginx 的作用是终止 TLS、转发请求和隐藏应用端口。示例配置如下,域名和证书路径需要替换为实际值:

三、按低风险顺序实施变更|配置 Nginx 作为唯一公网入口配图

server {
    listen 80;
    server_name example.com www.example.com;

    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name example.com www.example.com;

    ssl_certificate     /etc/ssl/example.com/fullchain.pem;
    ssl_certificate_key /etc/ssl/example.com/privkey.pem;

    access_log /var/log/nginx/example.access.log;
    error_log  /var/log/nginx/example.error.log warn;

    location ^~ /actuator/ {
        return 404;
    }

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_connect_timeout 5s;
        proxy_read_timeout 60s;
    }
}

修改前先备份当前站点配置,修改后必须先检查语法,再平滑加载:

sudo nginx -t
sudo systemctl reload nginx

证书至少检查有效期、域名和私钥权限:

sudo openssl x509 -in /etc/ssl/example.com/fullchain.pem -noout -subject -dates
sudo stat /etc/ssl/example.com/privkey.pem

证书自动续期也属于生产条件的一部分。不能只验证当前证书有效,还应确认续期程序、续期后的 Nginx reload 以及失败告警都存在。证书续期测试应在明确的维护窗口内进行,避免直接在业务高峰修改入口。

5. 复核公网端口和防火墙

应用端口 8080 不应对公网开放。最终通常只需要:

端口访问方向典型用途处理要求
22管理来源到服务器SSH 运维按办公网或跳板机限制来源
80公网到服务器HTTP 跳转或证书校验只保留必要入口
443公网到服务器HTTPS 业务访问由 Nginx 接收
8080仅本机Spring Boot不应出现在公网监听规则中

先查看而不是直接修改防火墙:

sudo ss -lntp
sudo ufw status verbose

如果使用云安全组,还要在云平台侧核对规则。防火墙调整会立即影响 SSH、业务访问和监控采集,修改前应保存原规则,并准备从云厂商控制台或带外终端恢复的路径。除非已经确认管理来源 IP,否则不要在远程 SSH 会话中直接收紧 22 端口。

四、分层验证并设置观察窗口

1. 先验证应用进程和本机健康状态

先看 systemd 状态和启动日志:

sudo systemctl status myapp --no-pager
sudo journalctl -u myapp -n 100 --no-pager

再从服务器本机访问健康检查:

curl -fsS http://127.0.0.1:8080/actuator/health
curl -fsS http://127.0.0.1:8080/actuator/health/readiness

如果返回失败,应根据结果区分:

四、分层验证并设置观察窗口|先验证应用进程和本机健康状态配图

  • 连接被拒绝:应用没有启动或监听地址、端口不对;
  • 返回 404:Actuator 未引入、路径不匹配或端点未暴露;
  • 返回 DOWN:优先检查数据库、缓存或外部依赖;
  • 返回 UP 但业务请求失败:健康检查覆盖范围不足,需要继续做业务验证。

2. 再验证 Nginx、TLS 和域名

在 DNS 尚未切换或仍处于缓存阶段,可以用 curl --resolve 将指定域名临时解析到香港服务器公网 IP:

curl -fsS --resolve example.com:443:203.0.113.10 \
  https://example.com/actuator/health

生产环境不应使用 -k 忽略证书错误。应检查:

  • 证书域名与访问域名一致;
  • HTTP 是否按预期跳转到 HTTPS;
  • HTTPS 返回状态码是否正确;
  • Host、客户端 IP 和协议头是否被 Spring Boot 正确识别;
  • 应用端口从公网无法直接访问。

业务接口可用以下方式观察状态码和响应时间:

curl -sS -o /dev/null \
  -w 'code=%{http_code} dns=%{time_namelookup}s connect=%{time_connect}s total=%{time_total}s\n' \
  https://example.com/api/health

如果站点有登录、文件上传、回调、定时任务或异步消息,还应选择一组低风险业务动作做验证。只检查首页或健康端点,不能证明数据库写入、回调签名和后台任务都正常。

3. 观察日志和资源变化

应用日志建议优先统一输出到 journald 或集中日志系统,避免同时写大量文件日志和标准输出,造成重复占用磁盘。上线后至少检查:

sudo journalctl -u myapp --since "10 minutes ago" --no-pager
sudo journalctl -u nginx --since "10 minutes ago" --no-pager
sudo journalctl --disk-usage
df -hT
free -h

重点关注:

  • 是否出现连续重启;
  • 是否出现 OutOfMemoryError、连接池耗尽或数据库拒绝连接;
  • Nginx 的 4xx、5xx 是否明显增加;
  • 请求耗时是否比发布前基线明显升高;
  • CPU、内存、磁盘和 JVM GC 是否持续逼近上限;
  • 香港服务器到数据库、缓存和第三方服务的连接是否出现超时;
  • 证书、DNS 和外部回调是否仍然正常。

日志保留量需要结合磁盘容量、访问量和合规要求设置。可以先确认 journald 和 Nginx 的日志轮转策略,不要等磁盘写满后再处理。

五、回滚条件、动作和边界

1. 建议提前写明触发条件

下面是可用于变更单的示例条件,具体阈值应以发布前基线和业务重要性为准:

  • 应用无法通过 readiness 检查,连续 3 次或持续约 1 至 2 分钟;
  • 关键业务接口持续返回 5xx,或错误率明显高于发布前水平;
  • 平均或 P95 响应时间持续达到发布前约 2 倍,并确认与本次版本有关;
  • 服务反复重启、出现 OOM、线程池耗尽或数据库连接池耗尽;
  • 新版本与现有数据库结构不兼容;
  • TLS、DNS 或 Nginx 配置错误导致公网流量无法正常进入;
  • 外部回调、支付、消息消费等关键链路出现无法接受的业务错误。

单个慢请求不一定需要回滚,但持续性错误、数据写入异常和不可逆数据库迁移应提高处理等级。

2. 应用包回滚

如果确认问题只在应用包,且数据库结构仍兼容旧版本,可以切回上一发布目录:

readlink -f /opt/myapp/current
ls -1dt /opt/myapp/releases/*

确认上一版本路径后执行:

sudo systemctl stop myapp
sudo ln -sfnT /opt/myapp/releases/20250301-02 /opt/myapp/current
sudo systemctl start myapp

回滚后重新执行本机健康检查、Nginx 入口检查和关键业务验证。停止服务会造成中断,单实例环境应在确认回滚必要后再执行。

如果已经执行了不可逆数据库迁移,不要只切换 JAR 包。应暂停继续写入,依据数据库备份和迁移方案决定是前向修复、恢复备份,还是部署兼容版本。

五、回滚条件、动作和边界|应用包回滚配图

3. Nginx 或证书配置回滚

如果应用本机正常,但公网入口异常,先判断是 Nginx 语法、证书、反向代理还是 DNS 问题。恢复备份配置后必须重新检查:

sudo cp -a /etc/nginx/sites-available/myapp.bak.变更时间 \
  /etc/nginx/sites-available/myapp

sudo nginx -t
sudo systemctl reload nginx

上面的备份文件名应替换为实际保存的文件,不能直接照抄。若只是 DNS 切换问题,只有在旧服务器仍在线且数据状态可接受时,才考虑恢复 DNS 指向;DNS 缓存不会因修改记录而立即在所有客户端同时更新。

4. 观察窗口结束标准

低流量站点至少观察一个完整的业务高峰或主要任务周期;有定时任务、批处理、消息消费或高峰流量的系统,应覆盖这些场景后再关闭变更窗口。观察期间持续记录应用版本、服务重启次数、5xx、响应时间、资源使用、数据库错误和外部依赖状态。

只有在健康检查稳定、关键业务验证通过、日志没有持续异常,并且没有触发预先定义的回滚条件后,才可以把本次发布标记为完成。否则应优先保留旧版本和原配置,按照既定条件回滚,而不是在生产环境中连续叠加未经验证的修复。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8313.html

相关推荐