> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oddspapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# WebSocket故障排除 - 常见问题和解决方案

> 调试OddsPapi WebSocket连接问题。登录错误、空响应、二进制解码、背压断开连接和恢复失败的解决方案。

## 1) 登录错误

### "first message must be login"

发送有效的`login`作为您的第一帧。

### `login_failed`

* 缺少/无效的`apiKey`
* 没有允许或请求的频道
* 博彩公司不被允许

### `too_many_connections` (4003)

* 达到您的密钥组的最大连接数（最大：5）
* 分片或减少并发连接
* 联系支持以提高限制

***

## 2) 已连接但未收到任何内容

* 未订阅预期的频道？检查`login_ok.channels`
* 过滤器太窄？例如空的`sportIds`或无效的`bookmakers`
* 博彩公司门控过滤器：
  * 如果上游消息没有匹配的博彩公司键，它会被过滤掉

***

## 3) 二进制解码问题

使用`receiveType: "binary"`时：

* 数据帧：MessagePack
* 控制帧：JSON

您必须解码两者。

***

## 4) 恢复期间的`snapshot_required`

意味着服务器无法安全重放。可能的原因：

* `server_restarted`
* `resume_window_exceeded`
* `client_backpressure`

> 如果您的`lastSeenId`太旧，即使短暂的断开连接也可能超过缓冲区。

恢复：

* 通过REST重新获取快照
* 重置您的`lastSeenId`
* 继续流式传输

***

## 5) 负载下断开连接（背压）

症状：

* 关闭代码`4002`
* 跳过的`odds`更新

修复：

* 使用`binary`
* 将解析推送到异步队列
* 按`sportIds`、`bookmakers`过滤

***

## 6) `entryId`中的间隙

`entryId`是一个游标——不是交付账本。预期存在间隙，原因包括：

* 上游跳过
* 网关合并
* 未重放的重新连接

***