# EMQX 5.10 已知问题

## 5.10.2

| 始于版本 | 问题描述                                                     | 解决方法                                                     | 状态              |
| -------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ----------------- |
| 5.1.0    | **向集群中添加新的核心节点时，副本节点可能在启动时挂起**<br />在添加新的核心节点等集群变更过程中，新添加的核心节点偶尔可能无法启动副本节点所需的复制相关进程，从而导致升级后的或新添加的副本节点在启动时挂起。<br />在 Kubernetes 部署中，这会导致控制器因就绪探针失败而反复重启副本 Pod。<br />该问题通常发生在滚动升级过程中。例如，将一个现有的 2 个核心节点 + 2 个副本节点的集群扩容，新增两个运行较新 EMQX 版本的核心节点和两个副本节点。 | 如果一个或多个副本节点在（重新）部署后启动时挂起，可考虑逐一强制重启新添加的核心节点，直到副本节点解除阻塞并完成启动。 | 已在 5.10.3、6.0.1 中修复 |
| 5.7.0    | **Cluster Link 垃圾回收可能删除活跃路由**<br />当配置了多个独立的 Cluster Link，且其中部分链接长时间保持断开状态时，垃圾回收进程可能会错误地从内部路由表中删除活跃路由。这可能导致受影响的 Cluster Link 只转发部分消息，或完全停止转发消息。 | -                                                            | 已在 5.10.3、6.1.0 中修复 |

## 5.10.0

| 始于版本 | 问题描述                                                     | 解决方法                                                     | 状态              |
| -------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ----------------- |
| 5.0.0    | **集群中路由表与会话注册表可能出现不一致**<br />在集群发生网络分区恢复、节点非正常关闭或清理过程中 RPC 超时等情况后，路由表和全局会话（Channel）注册表中可能残留陈旧条目或丢失正常条目。已知表现包括：<br />- 网络分区恢复后，副本节点（Replicant）上的订阅路由可能未能完全重新同步，导致部分订阅静默丢消息，直到对应节点重启才能恢复。<br />- 网络分区恢复后，副本节点上的 Channel 可能从全局会话注册表中丢失，进而导致会话接管行为异常（重新连接的客户端无法替换其旧会话）以及 Dashboard 中客户端计数失真。<br />- 当会话所有者进程异常结束且未完成清理性注销（例如出现短暂网络分区导致注销消息无法复制，或在 down-event 清理过程中核心节点的一致性检查超时），如果同名客户端 ID 不再连接，注册表中的该条目可能永久残留。随着时间推移，这类失效条目会持续累积。<br />相关修复已在 5.10 后续补丁版本及更新的发布线中合入。详见 emqx/emqx PR [#17076](https://github.com/emqx/emqx/pull/17076)、[#17257](https://github.com/emqx/emqx/pull/17257) 与 [#17522](https://github.com/emqx/emqx/pull/17522)。 | -                               | 请升级至 5.10.4+、6.1.2+ 或 6.2.1+ |