中继系统最难排查的一类问题是:WebSocket 已经连接成功,但控制命令没有结果。此时网络层看起来正常,继续检查端口和防火墙不会带来更多信息。

我的处理方式是建立一个独立协议探针,不依赖完整客户端界面,只验证最小控制链路。

探针做什么

探针负责构造控制帧、发送请求、解析响应,并记录超时、连接关闭、解析失败和服务端错误。鉴权信息只从环境变量读取,不写入脚本。

为了判断不同版本可能使用的命令形式,探针按有限列表发送兼容变体。一旦获得明确成功响应,就停止继续尝试。

为什么不用完整客户端测试

完整客户端还包含状态管理、界面事件和业务流程。任何一层都可能吞掉错误。独立探针减少了变量,可以明确回答三个问题:连接是否建立、帧是否被识别、命令是否受支持。

最终得到什么

  • 将“不能用”拆成可观察的协议状态。
  • 兼容验证可以重复执行并比较结果。
  • 超时和解析错误不再表现为无响应。
  • 鉴权信息与测试代码分离。

故障定位工具不需要复制整个产品。它只需要足够小,并且能对关键假设给出明确答案。