ICP备案

备案站点的健康检查与优雅停机

作者:备案源头内容团队内容审核:备案源头内容团队更新于 2026年9月9日

发布时的 502,多半不是代码问题

每次发版都有零星 502 或请求被截断,很多人以为是偶发抖动,其实原因很确定:新实例还没就绪就被放进流量,或者旧实例被直接杀掉、手里的请求没处理完。这两件事分别由健康检查和优雅停机负责,配好了就能做到发布期间零掉请求。发布策略本身见 灰度发布与蓝绿部署

关键要点

  • 就绪探针(readiness)决定"能不能接流量",存活探针(liveness)决定"要不要重启",两者不能共用一个接口。
  • 优雅停机的第一步是先从负载均衡摘除,而不是立刻关进程。
  • 容器环境要正确处理 SIGTERM,并把停机预留时间配得比实际耗时长。
  • 健康检查不要级联依赖下游,否则一个依赖抖动会导致全体实例被重启。

就绪 vs 存活:两个探针别混用

探针 回答的问题 失败后的动作
readiness 就绪 现在能否对外提供服务 从负载均衡摘除,不重启
liveness 存活 进程是否已经僵死 重启容器/进程

混用的典型事故是:把"数据库可连接"写进存活探针,结果数据库抖动一下,所有实例被判定为死亡并同时重启,小故障升级成全站宕机。存活探针应只检查进程自身是否还能响应。

优雅停机的完整流程

收到停机信号后,正确顺序是:

  1. 标记为不健康,让就绪探针开始失败。
  2. 等待负载均衡完成摘除(需要一个等待窗口,通常几秒到十几秒)。
  3. 停止接收新请求,但继续处理已在手的请求。
  4. 等待存量请求处理完毕或达到超时。
  5. 关闭数据库连接池等资源,退出进程。

第 2 步最容易被省略——进程立刻退出、但负载均衡还在往这台机器发请求,用户看到的就是 502。

容器环境下的信号处理

容器停止时会先发 SIGTERM、宽限期后发 SIGKILL。要点有三:应用必须自己捕获 SIGTERM 并执行上述流程;进程要跑在 PID 1 或使用 init 转发信号,否则收不到;宽限期要配得比实际停机耗时更长,否则还没处理完就被强杀。容器部署要点见 容器化部署要点

反向代理侧的配合

负载均衡或反向代理要开启连接 draining,并配置合理的重试与超时,让摘除过程平滑,见 Nginx 反向代理配置。发布期间的 5xx 曲线应纳入告警,见 备案网站监控告警体系

常见坑

  • 就绪与存活共用一个接口:依赖抖动引发全体重启。
  • 没有摘除等待窗口:进程退出太快,502 必现。
  • 不处理 SIGTERM:容器直接被强杀,请求全断。
  • 宽限期太短:优雅停机走到一半被 SIGKILL。

资料来源

Kubernetes 探针与 Pod 生命周期官方文档及主流负载均衡连接 draining 相关资料。本文为通用运维说明,仅供参考,具体以实际编排平台为准。

相关阅读

网站访问日志留存与安全合规运维要点

为什么要留日志:这是法定要求 《网络安全法》第二十一条明确要求网络运营者"采取监测、记录网络运行状态、网络安全事件的技术措施,并按照规定留存相关的网络日志不少于六个月"。已完成备案、对外提供服务的网站属于网络运营者范畴,日志留存不是可选项,而是基础合规义务。 应留存哪些日志 | 日志类型 | 记录内容 | 主要用途 …

网站新增域名如何补充接入备案

企业在原有网站基础上新增域名,比如启用新的品牌域名或拼音域名指向同一网站时,不能直接绑定使用,而是需要在原备案基础上补充办理新增域名的接入手续。 新增域名前的准备工作 新增域名前,建议先确认该域名已经完成实名认证,可以通过 Whois查询 核对域名的注册信息和实名状态,避免因域名信息未实名导致接入申请被退回。同时确认…

备案信息年度核查该如何配合应对

部分省份的通信管理部门会对辖区内已备案网站开展年度或不定期核查,核查方式包括系统比对、电话回访、短信确认等,目的是确认备案信息与网站实际运营情况是否一致。 核查通常关注哪些内容 年度核查一般围绕主体信息、网站信息、接入信息三个维度展开,具体可以对照下表自查: | 核查维度 | 常见核查点 | | --- | --- …

备案号在网站上的规范展示与使用要求

网站完成备案只是第一步,备案号在页面上的展示方式同样需要长期维护,很多主体正是因为展示细节不规范,在日常巡查或年度核查中被要求整改。 展示位置与基本要求 通常做法是将备案号放置在网站首页底部,文字需清晰可辨、不被图片或广告遮挡,且格式应与下发的备案号文本保持一致,不能随意增减字符或调整顺序。是否需要加超链接指向查询入…

备案注销之后重新申请要注意什么

有些主体在此前因业务调整、接入商变更等原因注销了原有备案,之后又因新的业务需要重新申请备案。这种“二次备案”与首次备案在流程上大体相似,但有几个环节容易被忽略。 重新申请前的自查 重新申请前,建议先用 ICP备案查询 确认原备案是否确实已经完成注销,避免出现原备案未彻底清空、新申请与旧记录冲突的情况。同时检查计划使用…

备案信息变更有没有时效要求

备案不是办理完成后就一劳永逸的事项,主体信息、网站信息或联系方式一旦发生变化,通常需要在信息变化后的一定时间内完成变更提交,具体时限以属地管局要求为准。 哪些变化需要及时申报 常见需要变更的情形包括:主办单位名称或证件信息变化、网站负责人更换、联系电话或邮箱失效、网站域名调整、网站内容服务类型发生实质变化等。这类变更…

公司迁址之后备案地址信息如何更新

企业办公地址或注册地址发生变化后,备案信息中登记的地址项也需要相应更新,尤其是当迁址涉及跨区、跨市甚至跨省时,办理流程会比同城内迁址更复杂一些。 迁址后需要关注的信息 迁址后首先要确认工商登记信息是否已经完成同步变更,备案地址一般以工商登记的最新地址为准。可以先用 ICP备案查询 查看当前登记的主办单位地址,与最新的…

备案预留手机号邮箱变更该如何更新

备案信息中登记的手机号和邮箱,是管局与接入服务商联系网站负责人的主要渠道,用于发送核查通知、验证短信、审核结果等重要信息。这些联系方式一旦更换却未同步更新,容易导致关键通知被漏收。 常见需要更新的场景 负责人更换手机号或离职导致原号码停用; 企业邮箱系统迁移,原邮箱地址不再使用; 备案负责人变更,联系方式随之更换。 …

系统学习