请审查 的 WebSocket 接入,输出与现有网关及客户端兼容的配置和验收方案。
输入:WebSocket 入口和上游 ;Nginx 与 SDK 版本 ;代理层级 ;心跳与重连约定 ;当前配置和断连日志 。
1. 区分业务信令、文件上传下载及音视频媒体流,明确哪些请求经过此 Nginx。不要认为建立 WebSocket 就代表媒体通道或文件访问也已成功。
2. 追踪客户端握手到上游响应,核查路径、Host、认证和 Origin 判断。对于使用 HTTP/1.1 升级的链路,检查代理协议以及 Upgrade、Connection 的处理,并验证实际握手结果。
3. 为普通 HTTP 与长连接路径分别评估配置,避免无差别覆盖全站请求头。若使用腾讯云 IM,核对 SDK 版本和其对应代理域名;自有服务保留自己的域名与鉴权协议。
4. 结合业务心跳间隔和各代理的空闲超时定位断连。列出每层超时的含义,检查客户端是否在后台、弱网或网络切换时停发心跳;超时值依据实际约定确定。
5. 评估连接上限、文件描述符和单实例容量,使用测试环境的测量结果给建议。检查滚动发布时如何排空旧连接,以及重连后是否会重复执行有副作用的消息。
6. 验证握手失败、认证过期、正常消息、空闲保持、异常断开、重新连接及多实例发布。逐项记录连接状态、消息是否重复或丢失、恢复耗时和用户可见反馈。
输出:链路与超时对照、最小配置、断连原因证据、可复现测试步骤及容量待验证项。示例中的进程数、运行用户和网络地址不能直接迁入生产。
依据与范围
- [腾讯云 · IM 应对网络访问限制实践教程](https://cloud.tencent.com/document/product/269/122408)
核验日期:2026-09-08。依据公开资料改写的执行模板;原文是腾讯云 IM 接入示例;不照搬 root 用户、固定 worker 数量或示例网络地址。