Hazelcast客户端无法连接至服务器问题咨询

核心排查步骤 #

• 验证网络连通性
  在客户端机器上执行以下命令，确认服务器IP和端口可达：

  # 测试IP连通性
  ping 192.168.156.149
  # 测试端口开放状态
  telnet 192.168.156.149 5701
  # 或使用nc命令（若系统支持）
  nc -zv 192.168.156.149 5701
  

  若命令无响应，优先检查服务器防火墙是否开放5701端口，或客户端与服务器是否处于同一网络环境。

• 核对集群名称一致性
  客户端日志显示集群名称为simpleserver，需确保服务器hazelcast.xml中的<cluster-name>配置完全匹配：

  <hazelcast>
    <cluster-name>simpleserver</cluster-name>
    <!-- 其他配置项 -->
  </hazelcast>
  

  同时客户端代码中也需指定相同集群名称：

  ClientConfig config = new ClientConfig();
  config.setClusterName("simpleserver");
  

• 检查服务器网络绑定配置
  确认服务器hazelcast.xml的网络配置未绑定仅本地可访问的地址（如127.0.0.1），需设置为客户端可访问的IP：

  <hazelcast>
    <network>
      <public-address>192.168.156.149</public-address>
      <port>5701</port>
      <join>
        <multicast enabled="false"/>
        <tcp-ip enabled="true">
          <members>192.168.156.149</members>
        </tcp-ip>
      </join>
    </network>
  </hazelcast>
  

  若服务器仅绑定127.0.0.1，外部客户端无法建立连接。

• 确认客户端连接地址配置
  检查客户端代码是否正确指定了服务器地址和端口：

  ClientConfig config = new ClientConfig();
  config.getNetworkConfig().addAddress("192.168.156.149:5701");
  HazelcastInstance client = HazelcastClient.newHazelcastClient(config);
  

  避免地址拼写错误或端口不匹配。

• 版本兼容性校验
  当前客户端与服务器均使用5.1.2版本，此点符合要求，但需注意跨版本连接可能存在兼容性问题，建议保持版本一致。

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