# 常见问题
本文档汇集使用**事件与回调**可能出现的常见问题与解决方案

### 在使用长连接时，如果部署了多个实例，会如何选择实例呢？

**回答**：

实例采用随机选择策略，长连接无环境、机房归属区分，所有 client 权重相同；例如 A 环境机器人发送的消息，回调节点也可能分配至 B 环境。

### 飞书长连接会出现长时间收不到 pong 回复？cmd 窗口敲回车后才接收到，同时还有报 ERROR。

**回答：**
1. 网络差，检查一下是否有网络出流量限制。
2. 将CMD属性中的“快速编辑模式”关闭。

![jimeng-2026-02-12-9462-去除图片右下角的文字水印，保持其他所有内容不变.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/e8d60a50725bc8b2936b64c4800ef317_a9N4F6hWEI.png?lazyload=true&width=2048&height=2048)

### 使用长连接时，出现 not found handler 错误

**回答：**
1. 检查本地是否实现了对应的Handler
1. 如果有多个Client，检查每个Client是否实现了全部的Handler

### 配置了长连接并且开通了对应的事件，但是在后台日志中没有对应的事件。

**回答：**

**按照如下步骤检查**：
1. 切换至长连接模式后，应用是否完成发版；
2. 若涉及回调，检查搭建工具中配置的回调类型是否为对象。
3. 事件开通后需完成应用发版，请先核查应用是否已发版；若已订阅事件但事件日志无任何记录，说明订阅未成功，需联系技术支持排查。

### 长连接回调失败，报错“app not online”

**回答：**

若出现短时网络中断，SDK 会自动触发重连，网络恢复后即可正常使用；

### 配置了事件订阅，并且应用已经发版，但是在事件触发之后报 500 错误，原因是什么？

**回答**：

该问题通常因**应用存在多个在线长连接实例**所致：其中部分实例未实现对应监听事件的处理器（handler），进而触发 500 错误。

### 是否有方式能够查到应用建立了多少个长连接？

**回答：**

当前不支持查看应用已建立多少个长连接

### 使用事件订阅长连接方式，点击保存按钮的时候 提示：应用未建立长连接

**回答：**

订阅长连接前，需先确保已通过 SDK 在服务端 / 本地完成长连接的建立。

### 监听了指定的事件，但是会出现丢失事件的情况

**回答：**

该问题多因应用部署多个长连接实例，且部分实例未实现对应事件的 handler 所致。

### 长连接是否支持配置代理？

**回答：**

不支持。

### 卡片回调是否支持设置 LogID？

**回答：**

不支持

### 在使用长连接时，出现重复消费

**回答：**

**消息重复消费通常由以下两种原因导致：**

1. 业务 handler 处理逻辑异常并返回错误，触发消息重推机制；
2. 业务 handler 处理耗时超过 3s（事件要求 3s 内完成处理），触发消息重推，可通过异步启线程的方式解决。

### 卡片回调经常出现 200671 报错

**回答：** 
该错误属于业务错误，找技术支持排查，不属于 SDK 的问题。

**可能的原因**：
1. 开放平台 SDK 仅支持对象类型的卡片回传参数，不兼容字符串类型，该问题系用户在卡片模板中参数配置类型错误导致。
2. 用户编写的服务端逻辑有问题