服务器上的应用发布后,如何用健康检查判断新版本能否接收请求?
应用发布完成,不等于新版本已经具备接收请求的条件。进程可能处于运行状态,但端口未监听、数据库连接未建立、负载均衡仍指向旧实例,或者真实业务请求已经出现超时。因此,交付验收不能只看“服务启动成功”,而要确认新版本从实例状态到实际请求链路都能正常工作。
判断新版本是否可以接收请求,至少要核对四类结果:实例是否启动了目标版本,健康检查是否返回“可接收流量”,用户请求是否经过正确的入口到达新实例,以及在一定观察窗口内错误率、延迟和资源指标是否保持在约定范围内。只有这些条件同时满足,才适合把新版本标记为验收通过。
先确定验收口径
“能接收请求”通常包含以下几个层次。不同层次对应的检查对象不能混为一个健康接口。

| 检查对象 | 主要核对项 | 判断依据 |
|---|---|---|
| 发布实例 | 进程、容器、监听端口、版本标识 | 实例处于运行状态,监听地址和端口正确,运行版本与发布单一致 |
| 存活状态 | 进程是否仍能响应探测 | 进程未退出、事件循环或基础服务仍可响应 |
| 就绪状态 | 是否满足接收业务流量的条件 | 关键依赖已连接,初始化完成,接口返回明确的就绪状态 |
| 请求入口 | 域名、反向代理、负载均衡到新实例的路径 | 从实际访问入口发起请求时,能够命中新版本 |
| 业务结果 | 代表性接口的状态码、响应内容、依赖调用 | 返回符合接口约定的结果,没有异常超时或关键依赖错误 |
| 运行稳定性 | 错误率、延迟、重启、资源使用量 | 在约定观察窗口内没有明显劣化或反复摘除 |
如果采用滚动发布或灰度发布,还要增加一个条件:只有通过就绪检查的新实例才能进入流量池;未通过检查的实例应保持摘除状态,而不是让请求随机失败。
1. 发布实例:确认运行的确实是新版本
核对版本身份
首先确认服务器上运行的实例不是旧进程,也不是发布目录更新了但进程仍加载旧代码的情况。可核对以下信息:
- 发布编号、Git 提交号或构建时间;
- 进程或容器的启动时间;
- 应用实际加载的配置版本;
- 监听端口和绑定地址;
- 实例是否存在反复重启、启动后立即退出的现象。
如果服务器使用 systemd 管理应用,可以先查看服务状态;如果使用容器,则应通过容器平台查看实例状态。下面的命令仅作核验示例,app.service 和 8080 需要替换为实际服务名和端口。
systemctl status app.service --no-pager
ss -lntp | grep ':8080'
curl -fsS --max-time 3 http://127.0.0.1:8080/health/ready
判断时不能只看 systemctl 显示 active (running)。更可靠的结果应同时满足:
- 进程或容器状态正常;
- 监听端口与反向代理或负载均衡配置一致;
- 返回的版本标识与本次发布记录一致;
- 就绪接口在连续多次请求中都能及时返回成功;
- 没有频繁重启、内存溢出或启动异常日志。
如果本机访问就绪接口成功,但通过业务域名访问失败,说明应用进程本身可能正常,问题仍可能出现在反向代理、负载均衡、TLS、DNS或安全策略上,不能直接判定发布完成。
版本信息应便于验收
应用可以提供内部版本接口,或者在响应头、结构化日志和监控标签中记录版本号。例如内部探测结果可以包含:
{
"status": "UP",
"ready": true,
"revision": "release-2025-03-08-abc123"
}
版本接口不应返回数据库密码、内部地址、环境变量或完整依赖拓扑。若接口暴露在公网,可通过访问控制、内网路径或网关规则限制访问。验收需要的是“能确认版本”,不是把服务器内部信息公开给所有访问者。
2. 健康检查:区分存活、就绪和业务检查
存活检查不等于就绪检查
健康检查至少应区分两种含义:

| 检查类型 | 要回答的问题 | 适合检查的内容 | 失败后的处理 |
|---|---|---|---|
| 存活检查(Liveness) | 进程是否还在工作? | 进程、事件循环、基础线程或最小响应能力 | 触发重启或标记实例异常 |
| 就绪检查(Readiness) | 现在是否适合接收请求? | 初始化完成、关键配置加载、必要依赖可用 | 从流量池摘除,通常不立即重启 |
存活检查不宜强依赖数据库、缓存或第三方服务。否则某个外部依赖短暂故障时,平台可能不断重启本来可以恢复的应用,造成更大范围的不稳定。
就绪检查则应覆盖新版本真正需要的关键条件。例如,应用必须连接数据库才能处理核心接口,那么数据库连接建立前就不能返回“就绪”;如果某个统计服务只影响非核心功能,则不一定要因为它暂时不可用而摘除整个实例。判断标准应与应用的实际请求依赖对应。
核对状态码和返回语义
就绪检查建议使用稳定、明确的状态码:
200:应用已经完成初始化,可以接收流量;503:应用仍在启动、正在摘除,或关键依赖暂不可用;500:检查逻辑本身异常,通常应视为发布异常;- 超时、连接拒绝或无响应:实例不可接受流量。
负载均衡器不能只判断接口“有响应”,还要判断状态码是否符合预期。一个返回错误页面但状态码为 200 的接口,可能会被错误地认为健康。
健康接口的返回内容可以包含状态、版本和必要的检查结果,但不建议把每个依赖的详细错误直接暴露给公网。对内部监控而言,可以在日志或监控指标中记录更详细的失败原因。
注意启动阶段和摘除阶段
新实例启动时,应用可能需要加载配置、执行数据库连接池初始化、读取缓存或预热运行时。此时进程已经存在,但还不能接收请求。验收时要观察:
- 启动后是否经过合理的初始化时间;
- 初始化期间是否被过早加入流量池;
- 就绪状态是否从失败稳定切换为成功;
- 停止发布时是否先变为未就绪,再等待已有请求完成。
如果启动时间较长,应使用平台支持的启动探测或合理的初始延迟,避免把正常初始化误判为故障。相反,不能为了避免失败而设置过长的探测宽限时间,否则真正启动失败会被延迟发现。
3. 请求入口:从真实访问路径确认流量能到达新实例
不要只在本机访问
本机执行 curl http://127.0.0.1:8080/health/ready,只能证明本机端口和应用之间基本连通,不能证明用户请求可以正常到达。验收应至少从实际入口检查一次:

curl -sS --max-time 5 -D - \
-H 'Accept: application/json' \
'https://app.example.com/health/ready'
需要核对的结果包括:
- 域名解析是否指向当前入口;
- TLS证书和协议是否正常;
- 反向代理是否把请求转发到预期端口;
- 负载均衡器是否将新实例标记为可用;
- 健康检查路径是否与应用实际路径一致;
- 返回状态码、响应体和版本标识是否符合预期。
如果系统存在多台新实例,不能只抽查其中一台。应确认每个实例都已通过就绪检查,或者通过实例标签、响应头、日志字段确认请求确实覆盖了本批次实例。
区分健康探测和业务请求
健康接口通常不需要登录,也不应修改数据。它适合判断实例是否可用,但不能证明鉴权、路由、业务逻辑和数据库读写都正确。因此还要选择至少一个不会产生真实副作用的代表性业务请求:
curl -sS --max-time 10 \
-o /tmp/release-check.body \
-w 'status=%{http_code} total=%{time_total}s\n' \
-H 'Accept: application/json' \
-H 'X-Release-Check: release-2025-03-08' \
'https://app.example.com/api/v1/items?limit=1'
这里的接口、路径和请求头只是示例。生产环境不应把真实令牌、用户隐私或敏感参数直接写入命令历史。若必须验证写入流程,应使用专门的测试租户、测试数据和可回收的业务操作,并事先确认清理方式;不能用真实订单、支付或用户数据作为发布探针。
4. 代表性请求:确认业务结果和依赖关系
按请求实际依赖选择验证项
不同类型的应用,代表性请求并不相同。可以按照请求是否依赖关键组件来选择:
| 请求类型 | 应核对的内容 | 通过依据 |
|---|---|---|
| 静态或无状态接口 | 路由、状态码、响应格式 | 返回内容符合接口约定,响应时间在目标范围内 |
| 数据库读取接口 | 连接、SQL、数据映射、权限 | 返回结构正确,没有连接失败、字段缺失或超时 |
| 登录或鉴权接口 | 密钥、会话、权限配置 | 合法请求成功,非法请求按预期被拒绝 |
| 缓存依赖接口 | 缓存连接和未命中处理 | 缓存正常时可返回,缓存异常时有明确降级或失败行为 |
| 消息或异步接口 | 连接、序列化、投递结果 | 消息格式兼容,未出现重复投递或关键投递失败 |
不能因为 /health/ready 返回 200,就推断数据库查询、鉴权或消息投递都已经正确。就绪检查只应覆盖定义为“进入流量前必须满足”的条件,业务接口则需要使用真实请求验证业务契约。
检查响应内容,而不只看状态码
验收时建议同时记录以下结果:
- HTTP状态码是否符合接口约定;
- JSON字段、数据类型和分页结构是否正确;
- 是否出现空响应、旧字段、序列化错误;
- 日志中是否有异常堆栈、连接池耗尽或超时;
- 响应时间是否明显高于旧版本;
- 请求是否真正落到了新版本实例。
例如,接口返回 200,但响应中的关键字段为空,或者返回了旧版本格式,仍应视为验收异常。对于有兼容性要求的接口,还要特别检查新版本与现有客户端、数据库表结构、缓存数据格式之间是否兼容。
数据库变更是常见风险点。若新代码依赖尚未完成的字段或索引,健康接口可能正常,业务请求却会在上线后失败。验收时应至少验证一条依赖新结构的读取路径,并确认已有数据仍能被新版本正确处理。
5. 观察指标:确认新版本在实际流量下保持稳定
单次请求成功只能说明“当时能通”,不能证明新版本在持续流量下稳定。发布后的观察窗口内,应查看新版本实例,而不是只看整个集群的聚合数据。
重点指标及判断方式
| 指标 | 重点观察内容 | 示例判断方式 |
|---|---|---|
| 就绪成功率 | 是否反复在就绪和未就绪之间切换 | 观察窗口内持续为成功,不出现周期性摘除 |
| 请求量 | 新版本是否实际收到业务请求 | 灰度实例有预期流量,不能只有健康探测请求 |
| 5xx错误率 | 应用异常、上游错误、网关错误 | 小范围验收可要求无新增5xx;正式门槛以既定SLO为准 |
| 4xx错误率 | 参数、鉴权或路由是否发生变化 | 排除预期拒绝后,异常4xx不应明显增加 |
| 延迟 | p50、p95或p99是否劣化 | 不超过既定SLO;没有基线时可将基线升高约20%作为预警参考 |
| 重启和资源 | OOM、重启、CPU、内存、连接数、文件描述符 | 无异常重启,资源没有持续增长或接近上限 |
| 依赖指标 | 数据库、缓存、消息系统的错误和延迟 | 新版本没有引入明显的依赖压力或调用失败 |
上述数值是验收口径示例,不是所有应用都适用的固定标准。对于低流量服务,不能只等待几十秒就下结论,可以延长观察时间,覆盖一个完整的业务高峰或至少一轮代表性业务操作。对于高流量服务,则应按请求量、错误预算和灰度比例设置门槛。
一个较实用的示例是:灰度发布后连续观察10至15分钟,并确保新版本处理了足够数量的代表性请求;就绪检查持续成功,5xx没有新增异常,p95延迟没有超过既定SLO,且没有重启、OOM或明显的依赖错误。若业务流量不足,则应延长时间,而不是机械地以分钟数作为唯一依据。
关注单实例异常
聚合指标可能掩盖单个实例的问题。例如,10台实例中只有1台版本配置错误,整体错误率看起来仍然很低,但请求命中该实例时会间歇性失败。因此应分别核对:

- 每台新实例的就绪状态;
- 每台实例的请求量和5xx;
- 每台实例的延迟和重启次数;
- 日志中的版本、实例ID和请求ID;
- 负载均衡器对每个目标的健康状态。
如果只有某一台异常,不应简单地把整体结果判定为通过。应先将异常实例保持摘除,再确认其余实例是否满足本批次验收条件。
6. 根据结果决定通过、待复核或不通过
可以用以下方式形成明确的交付判断:
| 结果 | 典型表现 | 验收处理 |
|---|---|---|
| 通过 | 版本正确、就绪成功、入口可达、代表性业务请求正常,观察指标在门槛内 | 记录验收证据,按发布策略继续放量或完成切换 |
| 待复核 | 本机健康但入口未通、请求量不足、指标样本过少,或仅有非关键依赖告警 | 暂不宣布完成,补充入口、流量或依赖验证 |
| 不通过 | 就绪返回503、业务接口5xx或超时、版本不符、实例反复重启 | 停止继续放量,按预先批准的回退方案恢复稳定版本 |
| 部分通过 | 部分实例正常,部分实例异常 | 保留正常实例,摘除异常实例,修复后重新执行同一批检查 |
出现失败时,不要直接重启所有实例或覆盖发布目录。应先保留失败时间、实例ID、版本号、请求ID和相关日志,再按照已有的回退方案处理。若新版本涉及数据库结构变化,回退前还要确认旧版本是否能兼容已经执行的迁移;不能仅凭应用包切回就认为可以安全恢复。
如果健康检查失败但应用日志没有明显错误,还要核对探测来源是否被防火墙、访问控制、认证中间件或反向代理改写。探测请求被要求登录、被重定向到统一认证页面,或者健康路径被代理到错误端口,都会造成“应用正常但健康检查失败”的结果。
7. 留存一份可复核的验收记录
交付验收不应只留下“已发布”这一句状态。建议至少记录以下内容:
- 发布编号、版本号、构建号和发布时间;
- 新实例列表、监听端口和健康检查地址;
- 存活、就绪和代表性业务请求的结果;
- 从实际域名访问时的状态码、响应时间和版本标识;
- 灰度或正式流量的比例、观察开始和结束时间;
- 5xx、异常4xx、p95延迟、重启和资源使用情况;
- 失败请求的请求ID、日志位置和处理结果;
- 参与确认的人员以及后续复核时间。
最终的验收判断应建立在“新版本实例可识别、就绪检查持续通过、真实入口能够路由、代表性请求结果正确、观察指标没有超出门槛”这组证据上。只要其中一项仍无法确认,就应保持待复核状态,而不是仅凭进程运行或单次 200 响应宣布新版本已经可以稳定接收请求。
对于需要发布新版本的企业网站、业务后台和接口服务,A5idc数据提供中国香港、美国、日本、新加坡等地区的物理服务器租用,涵盖不同计算、存储、带宽和线路配置。企业可结合访问区域与程序负载安排应用实例和数据资源,为新版本接收业务请求提供计算、存储与网络基础。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7446.html
