上线检查清单

这是一份可以逐项打勾的上线清单,覆盖应用配置、账号与权限、消息链路、聊天室/直播、回调与审核、安全、容量与可观测性、回滚。每一项都给出验证方式,不依赖“应该没问题”。

Text
□ 1  应用创建完成,AppKey/AppSecret 已保存到密钥管理(未进代码库/前端包)
□ 2  生产域名 HTTPS/WSS 可用;证书链正确;必要时配置根证书
□ 3  服务开通:单聊/群/聊天室/推送/回调/审核 按业务需要开启
□ 4  配额已按容量评估申请;限频策略已配置
□ 5  用户导入/注册流程幂等;Token 签发与吊销流程验证通过
□ 6  Open API 签名(时间戳/Nonce)联调通过;错误码分支已处理
□ 7  客户端连接/重连/离线补收/多端 验证通过(含弱网)
□ 8  消息发送失败重试复用 clientMsgId;收端按 messageId 去重
□ 9  聊天室:创建/join/离开/销毁策略/KV 公告/禁言/白名单 验证通过
□ 10 回调:URL/secret/事件订阅配置完成;验签+幂等+5s ACK 验证通过
□ 11 审核:敏感词+发送前回调+审核任务 演练通过;拦截文案确认
□ 12 推送:设备 token 注册验证;webhook 离线通知链路验证;知悉厂商发送未实现
□ 13 安全:日志脱敏、管理端访问控制、密钥轮换流程 已确认
□ 14 数据:保留期/注销/删除流程 已确认;备份策略已执行
□ 15 监控:连接数/消息量/错误率/回调失败率/延迟 告警已配置
□ 16 压测:连接阶梯、消息峰值、重连风暴、群发扇出 已覆盖
□ 17 回滚:旧版本/旧配置可切回;数据不丢;回滚演练完成
□ 18 文档:对接方拿到 Quick Start、错误码、限制与排障入口

逐项验证命令​

项验证方式期望
服务端健康curl -sS http://127.0.0.1:8080/healthHTTP 200
运行时契约curl -sS -H "X-Admin-Secret: …" http://127.0.0.1:8080/api/__contract/introspectidlVersion / operations / errors 与文档一致
服务开通调一次目标接口(如建群)未开通 1021;开通后 code=0
签名用错误 secret 调一次1018;正确 secret 返回 0
回调管理端发送测试事件接收端 200;投递日志 success
限频短时间超量调用HTTP 429 + 1008 + Retry-After
弱网断网/断 socket 后重连自动重连 + sync_done + 0 丢失(去重后)
上线前最后 30 分钟

把生产 AppKey/Secret 与回调 secret 再核对一遍(最常见事故:测试密钥上生产)。

确认管理端/Admin API 没有暴露在公网。

确认监控与告警接收人手机可用。

准备回滚包与回滚命令,并让值班同学复述一次。

相关页面​