VerneMQ集群环境下客户端断开请求未生效问题排查

核心原因 #

VerneMQ默认配置中，跨节点的客户端断开操作需要依赖特定的集群同步机制，若未开启相关配置，请求无法自动路由到客户端所在节点执行。

关键配置检查与调整 #

• 开启客户端元数据集群同步
  在所有节点的vernemq.conf中确保以下配置生效：

  cluster_sync_client_metadata = on
  cluster_client_expiry_interval = 30s
  

  cluster_sync_client_metadata是核心项，负责在集群节点间同步客户端连接状态、会话等元数据，让节点能定位到客户端所在的目标节点。

• 启用API集群路由功能
  若通过HTTP API发送断开请求，需开启API的自动路由：

  vmq_api_cluster_routing = on
  

  开启后，接收请求的节点会自动将断开指令转发到客户端实际连接的节点执行，无需手动指定目标节点。

• 验证集群连通性
  在任意节点执行命令确认集群状态：

  vmq-admin cluster show
  

  确保A、B、C三个节点均处于connected状态，无集群分区或同步延迟问题。

额外注意事项 #

• 若客户端使用持久会话，需同步开启cluster_persistence = on，保证会话信息在集群中同步，断开操作才能彻底清理会话数据。
• Kubernetes负载均衡的会话亲和性不影响最终效果，开启上述配置后，请求会自动完成跨节点路由。

内容的提问来源于stack exchange，提问作者Ramdinesh J P