迁移后新Backup节点无法连接Artemis ActiveMQ主节点问题排查

一、核心问题排查（缺失配置/环境差异） #

1. 跨VM+Docker的网络连通性 #

• 跨环境下，backup2必须能访问primary2的复制端口（默认5445，自定义需匹配），Docker Compose需用host网络模式或正确映射端口，避免容器内部端口未对外暴露。
• primary2的connectors必须配置对外可访问的IP/主机名，不能用容器内部的localhost或容器名（跨VM无法解析）。

2. 备份节点HA与集群配置错误 #

backup2的broker.xml需满足：

• ha-policy设为backup，replication-enabled="true"，且masterConnectorRef与primary2中定义的连接器名称完全一致。
• cluster-connection的static-connectors必须指向primary2的对外地址，不能用本地测试的localhost；connector-ref需指向自身对外的连接器。
• 需配置支持复制的acceptors，示例：

  <acceptor name="artemis">tcp://0.0.0.0:5445?tcpSendBufferSize=1048576;tcpReceiveBufferSize=1048576;protocols=CORE,AMQP,STOMP;useEpoll=true</acceptor>
  

3. 数据目录状态异常 #

• primary2的data/bindings/oldreplica.1是脑裂遗留的旧副本目录，主节点会拒绝与数据不一致的备份节点建立连接。backup2首次连接前必须清空自身data目录（bindings、journal等），确保全量同步。

4. 超时与脑裂防护配置不足 #

跨VM网络延迟高，需调整主备节点的复制超时参数：

<ha-policy>
  <primary>
    <replication-check-interval>30000</replication-check-interval> <!-- 30秒检查一次 -->
    <replication-timeout>60000</replication-timeout> <!-- 60秒超时 -->
  </primary>
</ha-policy>

同时确保主备节点的cluster-user、cluster-password完全一致，避免认证失败。

二、无数据丢失的修复步骤 #

1. 保持primary2运行稳定：当前primary2为主节点，暂不重启，避免数据风险。
2. 清理backup2本地数据：停止backup2容器，删除其data目录下所有文件，确保首次连接时从primary2全量同步。
3. 修正backup2配置：
   • 确认masterConnectorRef指向primary2已定义的连接器名称。
   • 确认static-connectors配置为primary2的对外IP+复制端口，示例：

     <cluster-connection name="my-cluster">
       <address>jms</address>
       <connector-ref>artemis</connector-ref>
       <static-connectors>
         <connector-ref>primary2-external</connector-ref>
       </static-connectors>
     </cluster-connection>
     

   • 确保acceptors监听0.0.0.0，允许外部访问。
4. 验证网络连通性：在backup2所在环境执行nc -zv <primary2-ip> 5445，确认复制端口可访问。
5. 启动backup2并校验：
   • 查看primary2日志是否出现AMQ222037: Backup node connected。
   • 查看backup2日志是否出现AMQ222027: Replication succeeded, backup is now live。
6. 清理脑裂遗留目录：待backup2复制成功后，可在primary2停止维护时删除data/bindings/oldreplica.1，避免后续干扰。
7. 验证故障转移：关闭primary2，确认backup2自动升为主节点，再将primary2配置为备份节点重新加入集群。

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