Keycloak多实例集群配置失效问题求助

1. 确认配置文件加载路径 #

• 检查cache-ispn-tcp-ping.xml是否放在Keycloak的conf目录下，若路径不确定，启动时改用绝对路径指定配置文件，比如：

  nohup ./bin/kc.sh start --cache-config-file=/opt/keycloak/conf/cache-ispn-tcp-ping.xml --verbose &
  

• 加--verbose参数启动，查看日志中是否有「Loading configuration from...」类条目，确认配置文件是否被系统读取。

2. 校验cache-ispn-tcp-ping.xml核心配置 #

• 确保JGroups TCP绑定地址为0.0.0.0，对应配置段：

  <socket-binding name="jgroups-tcp" interface="public" port="7800"/>
  

• 检查TCP_PING配置是否正确填写集群实例IP，示例：

  <stack name="tcp">
      <transport type="TCP" socket-binding="jgroups-tcp"/>
      <protocol type="TCP_PING">
          <property name="initial_hosts">192.168.1.10[7800],192.168.1.11[7800]</property>
          <property name="num_initial_members">2</property>
      </protocol>
      <!-- 保留MERGE3、FD_SOCK、VERIFY_SUSPECT等必要协议段 -->
  </stack>
  

• 确认缓存容器默认使用该TCP栈：

  <cache-container name="keycloak" default-stack="tcp">
  

3. 排查keycloak.conf冲突配置 #

• 检查keycloak.conf中是否存在cache-stack参数，该参数会直接覆盖cache-config-file的设置，若有则注释或删除。
• 确保bind-address=0.0.0.0，避免实例仅绑定本地地址导致集群无法通信。

4. 端口与网络连通性验证 #

• 在两台实例上执行命令检查7800端口绑定状态：

  ss -tulpn | grep 7800
  

  若未显示绑定记录，说明配置未生效，回到配置文件重新校验。
• 测试实例间7800端口连通性：

  nc -zv 目标实例IP 7800
  

  若不通，检查防火墙、安全组是否放行该端口。

5. 确认启动命令参数有效性 #

• 检查启动命令中--cache-config-file参数拼写是否正确（注意双横杠），避免参数传递失败。
• 用进程命令确认参数是否被正确加载：

  ps aux | grep kc.sh
  

  确保--cache-config-file出现在进程参数列表中，排除nohup后台启动时的参数丢失问题。

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