技术问询：Infinispan的JGroups在Docker服务中无法加入同一集群

针对你在单Docker主机上部署两个独立Tomcat Web应用，却无法让它们的Infinispan嵌入式缓存通过JGroups加入同一集群的问题，我整理了几个常见的排查方向和解决办法：

1. 检查JGroups配置的成员发现机制 #

这是Docker环境下集群无法组建的最常见根源：

• 如果你的jgroups.xml用的是UDP多播（默认栈大概率是这个）：Docker默认桥接网络是禁用多播的，节点之间根本收不到彼此的发现消息。
  • 解决办法：要么创建支持多播的自定义Docker桥接网络（运行docker network create --driver bridge --opt com.docker.network.bridge.enable_icc=true --opt com.docker.network.bridge.name=jgroups-bridge，然后启动容器时指定这个网络）；要么直接切换到TCP栈，用TCP_PING配置指定两个Tomcat容器的IP地址，或者用dns.DNS_PING配合容器服务名（如果用Docker Compose管理的话）实现动态发现。
• 如果已经用了TCP栈：要确保TCP_PING的initial_hosts配置里包含所有集群节点的地址，避免只写了本地节点。

2. 确认JGroups绑定的网络地址 #

很多时候JGroups会默认绑定到容器内部的回环地址localhost，导致其他节点无法连接：

• 在jgroups.xml里检查UDP或TCP元素的bind_addr配置，建议设置为0.0.0.0（允许绑定到容器所有可用网络地址），或者直接指定容器的对外可访问IP。
• 同时别忘了配置external_addr，这个是节点对外暴露的地址，必须让集群内其他节点能访问到，比如可以用${jgroups.external_addr:0.0.0.0}占位符自动适配。

3. 统一集群名称配置 #

两个应用的集群名称不一致，肯定没法加入同一集群：

• 检查Infinispan配置中<cache-container>元素的name属性，确保两个Web应用的配置完全一致。
• 同时检查jgroups.xml里的cluster属性（如果有配置的话），也要保持统一。

4. 验证端口连通性 #

JGroups需要特定端口进行通信，Docker容器没正确暴露端口会直接阻断连接：

• 如果用UDP，默认需要开放55200多播端口，以及单播端口范围（可以在jgroups.xml里用port_range指定固定范围，方便Docker端口映射）。
• 如果用TCP，默认需要开放7800端口，以及每个节点的监听端口。
• 可以在容器内部用nc -zv <目标容器IP> <端口>测试连通性，比如在第一个Tomcat容器里执行nc -zv 172.17.0.3 7800（假设第二个容器IP是172.17.0.3），看是否能成功连接。

5. 开启日志定位细节 #

如果以上步骤都没解决问题，开启JGroups的DEBUG日志抓细节：

• 在Tomcat的logging.properties里添加配置：org.jgroups.level = FINEST，这样能看到JGroups节点发现、握手、连接的完整过程，比如有没有发送发现消息、有没有收到其他节点的响应，或者是否出现连接超时、被拒绝的报错。

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