服务器上的应用发布后,如何用健康检查判断新版本能否接收请求?

发布人:A5数据发布时间:2026-11-04 09:52阅读量:68

应用发布完成,不等于新版本已经具备接收请求的条件。进程可能处于运行状态,但端口未监听、数据库连接未建立、负载均衡仍指向旧实例,或者真实业务请求已经出现超时。因此,交付验收不能只看“服务启动成功”,而要确认新版本从实例状态到实际请求链路都能正常工作。

判断新版本是否可以接收请求,至少要核对四类结果:实例是否启动了目标版本,健康检查是否返回“可接收流量”,用户请求是否经过正确的入口到达新实例,以及在一定观察窗口内错误率、延迟和资源指标是否保持在约定范围内。只有这些条件同时满足,才适合把新版本标记为验收通过。

先确定验收口径

“能接收请求”通常包含以下几个层次。不同层次对应的检查对象不能混为一个健康接口。

先确定验收口径配图

检查对象主要核对项判断依据
发布实例进程、容器、监听端口、版本标识实例处于运行状态,监听地址和端口正确,运行版本与发布单一致
存活状态进程是否仍能响应探测进程未退出、事件循环或基础服务仍可响应
就绪状态是否满足接收业务流量的条件关键依赖已连接,初始化完成,接口返回明确的就绪状态
请求入口域名、反向代理、负载均衡到新实例的路径从实际访问入口发起请求时,能够命中新版本
业务结果代表性接口的状态码、响应内容、依赖调用返回符合接口约定的结果,没有异常超时或关键依赖错误
运行稳定性错误率、延迟、重启、资源使用量在约定观察窗口内没有明显劣化或反复摘除

如果采用滚动发布或灰度发布,还要增加一个条件:只有通过就绪检查的新实例才能进入流量池;未通过检查的实例应保持摘除状态,而不是让请求随机失败。

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. 健康检查:区分存活、就绪和业务检查

存活检查不等于就绪检查

健康检查至少应区分两种含义:

2. 健康检查:区分存活、就绪和业务检查配图

检查类型要回答的问题适合检查的内容失败后的处理
存活检查(Liveness)进程是否还在工作?进程、事件循环、基础线程或最小响应能力触发重启或标记实例异常
就绪检查(Readiness)现在是否适合接收请求?初始化完成、关键配置加载、必要依赖可用从流量池摘除,通常不立即重启

存活检查不宜强依赖数据库、缓存或第三方服务。否则某个外部依赖短暂故障时,平台可能不断重启本来可以恢复的应用,造成更大范围的不稳定。

就绪检查则应覆盖新版本真正需要的关键条件。例如,应用必须连接数据库才能处理核心接口,那么数据库连接建立前就不能返回“就绪”;如果某个统计服务只影响非核心功能,则不一定要因为它暂时不可用而摘除整个实例。判断标准应与应用的实际请求依赖对应。

核对状态码和返回语义

就绪检查建议使用稳定、明确的状态码:

  • 200:应用已经完成初始化,可以接收流量;
  • 503:应用仍在启动、正在摘除,或关键依赖暂不可用;
  • 500:检查逻辑本身异常,通常应视为发布异常;
  • 超时、连接拒绝或无响应:实例不可接受流量。

负载均衡器不能只判断接口“有响应”,还要判断状态码是否符合预期。一个返回错误页面但状态码为 200 的接口,可能会被错误地认为健康。

健康接口的返回内容可以包含状态、版本和必要的检查结果,但不建议把每个依赖的详细错误直接暴露给公网。对内部监控而言,可以在日志或监控指标中记录更详细的失败原因。

注意启动阶段和摘除阶段

新实例启动时,应用可能需要加载配置、执行数据库连接池初始化、读取缓存或预热运行时。此时进程已经存在,但还不能接收请求。验收时要观察:

  • 启动后是否经过合理的初始化时间;
  • 初始化期间是否被过早加入流量池;
  • 就绪状态是否从失败稳定切换为成功;
  • 停止发布时是否先变为未就绪,再等待已有请求完成。

如果启动时间较长,应使用平台支持的启动探测或合理的初始延迟,避免把正常初始化误判为故障。相反,不能为了避免失败而设置过长的探测宽限时间,否则真正启动失败会被延迟发现。

3. 请求入口:从真实访问路径确认流量能到达新实例

不要只在本机访问

本机执行 curl http://127.0.0.1:8080/health/ready,只能证明本机端口和应用之间基本连通,不能证明用户请求可以正常到达。验收应至少从实际入口检查一次:

3. 请求入口:从真实访问路径确认流量能到达新实例配图

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台版本配置错误,整体错误率看起来仍然很低,但请求命中该实例时会间歇性失败。因此应分别核对:

5. 观察指标:确认新版本在实际流量下保持稳定配图

  • 每台新实例的就绪状态;
  • 每台实例的请求量和5xx;
  • 每台实例的延迟和重启次数;
  • 日志中的版本、实例ID和请求ID;
  • 负载均衡器对每个目标的健康状态。

如果只有某一台异常,不应简单地把整体结果判定为通过。应先将异常实例保持摘除,再确认其余实例是否满足本批次验收条件。

6. 根据结果决定通过、待复核或不通过

可以用以下方式形成明确的交付判断:

结果典型表现验收处理
通过版本正确、就绪成功、入口可达、代表性业务请求正常,观察指标在门槛内记录验收证据,按发布策略继续放量或完成切换
待复核本机健康但入口未通、请求量不足、指标样本过少,或仅有非关键依赖告警暂不宣布完成,补充入口、流量或依赖验证
不通过就绪返回503、业务接口5xx或超时、版本不符、实例反复重启停止继续放量,按预先批准的回退方案恢复稳定版本
部分通过部分实例正常,部分实例异常保留正常实例,摘除异常实例,修复后重新执行同一批检查

出现失败时,不要直接重启所有实例或覆盖发布目录。应先保留失败时间、实例ID、版本号、请求ID和相关日志,再按照已有的回退方案处理。若新版本涉及数据库结构变化,回退前还要确认旧版本是否能兼容已经执行的迁移;不能仅凭应用包切回就认为可以安全恢复。

如果健康检查失败但应用日志没有明显错误,还要核对探测来源是否被防火墙、访问控制、认证中间件或反向代理改写。探测请求被要求登录、被重定向到统一认证页面,或者健康路径被代理到错误端口,都会造成“应用正常但健康检查失败”的结果。

7. 留存一份可复核的验收记录

交付验收不应只留下“已发布”这一句状态。建议至少记录以下内容:

  • 发布编号、版本号、构建号和发布时间;
  • 新实例列表、监听端口和健康检查地址;
  • 存活、就绪和代表性业务请求的结果;
  • 从实际域名访问时的状态码、响应时间和版本标识;
  • 灰度或正式流量的比例、观察开始和结束时间;
  • 5xx、异常4xx、p95延迟、重启和资源使用情况;
  • 失败请求的请求ID、日志位置和处理结果;
  • 参与确认的人员以及后续复核时间。

最终的验收判断应建立在“新版本实例可识别、就绪检查持续通过、真实入口能够路由、代表性请求结果正确、观察指标没有超出门槛”这组证据上。只要其中一项仍无法确认,就应保持待复核状态,而不是仅凭进程运行或单次 200 响应宣布新版本已经可以稳定接收请求。

对于需要发布新版本的企业网站、业务后台和接口服务,A5idc数据提供中国香港、美国、日本、新加坡等地区的物理服务器租用,涵盖不同计算、存储、带宽和线路配置。企业可结合访问区域与程序负载安排应用实例和数据资源,为新版本接收业务请求提供计算、存储与网络基础。

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

相关推荐