ActiveMQ Artemis与ZooKeeper同置集成失败问题排查

一、无ZooKeeper连接日志的可能原因 #

• HA配置层级错误：检查broker.xml中ha-policy的配置结构，必须确保zookeeper-lock嵌套在colocated→shared-store→lock节点下，且connect-string正确填写3台ZK的地址（逗号分隔）。如果配置节点层级混乱，Broker不会加载ZK相关逻辑，自然无日志输出。
• ZK依赖缺失：ActiveMQ Artemis的ZK HA功能需要artemis-zookeeper系列依赖包。手动部署时需确认这些jar已放入lib目录；Maven项目要检查是否引入对应依赖，缺失依赖会导致Broker无法初始化ZK客户端。
• 日志级别未开启：默认日志级别可能过滤了ZK相关信息。修改logging.properties或log4j2.xml，将org.apache.zookeeper和org.apache.activemq.artemis.core.server.ha的日志级别设为DEBUG：

  logger.zookeeper.name = org.apache.zookeeper
  logger.zookeeper.level = DEBUG
  logger.artemis-ha.name = org.apache.activemq.artemis.core.server.ha
  logger.artemis-ha.level = DEBUG
  

• 配置文件未正确加载：启动Broker时若指定了自定义配置路径，确认路径是否正确。比如执行./artemis run --xml /path/to/broker.xml时，若路径错误，Broker会使用默认配置，无ZK相关逻辑。
• 网络连通性问题：先手动验证Broker机器与ZK节点的网络，用telnet zk-host 2181或nc -zv zk-host 2181检查端口是否开放。若网络不通，开启DEBUG日志后会出现连接失败的记录。

二、ZooKeeper投票流程调试建议 #

• 开启ZK集群调试日志：修改ZK的log4j.properties，将org.apache.zookeeper.server日志级别设为DEBUG，可查看节点间投票、选举、同步的细节：

  log4j.logger.org.apache.zookeeper.server=DEBUG
  

• 使用ZK自带工具监控：
  • 执行zkServer.sh status查看每个ZK节点的角色（leader/follower/observer），确认集群是否正常选出leader。
  • 用zkCli.sh连接ZK集群，执行ls /artemis（默认Artemis根节点，可根据配置调整）查看Broker注册的锁节点，用get /artemis/your-broker-name/lock查看锁持有者信息。
• 跟踪Artemis的ZK锁逻辑：关注Artemis DEBUG日志中ZooKeeperLockManager相关输出，会记录锁的获取、释放、ZK节点监听等过程，比如Attempting to acquire lock、Lock acquired等日志，可清晰看到Broker参与HA选举的流程。
• 抓包分析ZK通信：用tcpdump或wireshark抓取Broker与ZK之间的2181端口数据包，判断是否有ZK协议通信。无通信说明Broker未初始化ZK客户端；有通信但失败可从包中定位错误原因。
• 检查ZK选举配置：确认ZK的zoo.cfg中electionAlg（默认FastLeaderElection）、quorumListenOnAllIPs、server.x配置正确，3台ZK的myid需唯一且与server.x编号对应，同时确保2888（集群通信端口）和3888（选举端口）互通。

内容的提问来源于stack exchange，提问作者Nazar Fatikhov