上线检查清单

完成开发联调后，按这张清单做一次上线验收。每一项都应有明确负责人和可验证结果。

凭证与权限

• 调用凭证只保存在服务端密钥系统或环境变量中。
• 测试环境与生产环境使用不同应用的调用凭证。
• 日志、告警和错误上报会遮盖调用凭证、手机号和消息正文。
• 调用凭证泄露后有明确的重置与服务更新流程。

实例与网络

• 登录网络已在平台代理、自定义代理、Aid 中明确选择一种。
• 业务系统保存稳定的 wcId，掉线重登时沿用原值。
• 每次登录返回的 wId 会更新到当前实例记录。
• 已接入在线状态、掉线原因和异常告警。

调用与限速

• 同一 wId 的发送任务进入串行队列。
• 重试次数有限，并使用退避和随机延迟。
• 超时不等于失败，不会直接重复执行高风险动作。
• 耗时接口单独设读超时：执行微信登录要 260 秒以上，初始化通讯录要 200 秒以上。
• 媒体上传、下载和大文件任务使用异步队列。

Webhook

• 使用稳定且公网可访问的 HTTP 或 HTTPS 业务地址；生产环境建议使用 HTTPS，不依赖开发电脑或临时隧道。
• 保存成功后立即返回 2xx，耗时业务先入队再处理；用兼容接口设置的地址，推送超时为 6 秒。
• 控制台配置的地址按 X-Eyun-Event-Id 去重，消息按账号与 newMsgId 去重；newMsgId 按字符串保存，见大整数。
• 需要确认推送来自 Eyun 时，已在控制台「收进来」生成密钥，并在接收端比对 X-Eyun-Signature，见Webhook 可靠性 · 来源校验。
• 重复、乱序、延迟和无关事件都有处理策略。

上线验证

验证项	验证方式
登录可恢复	主动下线测试账号，再使用原 wcId 恢复
发送可追踪	从业务单号追踪到请求、响应和微信实例
回调可排重	重放同一条回调，不产生重复业务动作
异常可告警	模拟离线、超时和回调 500，确认告警触发

详细频率和风控边界见 API 使用与安全。