香港服务器部署Spring Boot应用,生产上线前要准备什么
生产上线前,香港服务器上的 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. 准备日志、健康检查和数据库条件
生产环境至少应能回答三个问题:
- 应用当前是否存活;
- 应用是否已经可以接受业务流量;
- 应用异常时,能否定位到启动错误、数据库错误或外部接口错误。
如果使用 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、转发请求和隐藏应用端口。示例配置如下,域名和证书路径需要替换为实际值:

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



