Skip to content

EMQX 5.10 已知问题

5.10.2

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

5.10.0

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