如何实现Nuix-REST API服务器内嵌Hazelcast连接ZooKeeper及类路径排查

1. 配置Hazelcast通过Nuix-REST API连接ZooKeeper #

要替换默认TCP/IP发现为ZooKeeper动态发现，需完成以下配置步骤：

• 修改Hazelcast配置文件：找到应用使用的hazelcast.xml或hazelcast.yaml（无则新建），替换原有TCP/IP集群配置，添加ZooKeeper发现策略配置：

  <hazelcast>
    <network>
      <join>
        <!-- 禁用原有TCP/IP发现机制 -->
        <tcp-ip enabled="false"/>
        <!-- 启用ZooKeeper发现策略 -->
        <discovery-strategies>
          <discovery-strategy enabled="true" class="com.hazelcast.zookeeper.ZookeeperDiscoveryStrategy">
            <properties>
              <!-- ZooKeeper集群节点地址，多节点用逗号分隔 -->
              <property name="zookeeper_url">zk-node1:2181,zk-node2:2181,zk-node3:2181</property>
              <!-- Hazelcast集群在ZooKeeper中的专属命名空间，避免集群冲突 -->
              <property name="zookeeper_path">/hazelcast/nuix-cluster</property>
              <!-- ZooKeeper连接超时时间（毫秒） -->
              <property name="connection_timeout">10000</property>
            </properties>
          </discovery-strategy>
        </discovery-strategies>
      </join>
    </network>
  </hazelcast>
  

• 让Nuix-REST加载自定义配置：在Nuix-REST的启动脚本或启动参数中，添加JVM参数指定Hazelcast配置文件路径：

  -Dhazelcast.config=/path/to/your/custom-hazelcast.xml
  

  确保该路径对应用程序进程可访问，且配置文件格式无语法错误。
• 验证网络连通性：确认Nuix-REST服务器所在节点能访问ZooKeeper集群的2181端口（默认端口），可通过telnet zk-node1 2181或nc -zv zk-node1 2181测试。

2. 确认hazelcast-zookeeper.jar是否在CLASS_PATH中 #

可通过以下几种方式验证：

• 检查启动脚本配置：查看Nuix-REST的启动脚本，确认-cp参数或CLASSPATH环境变量是否包含存放该JAR的lib目录，或直接包含该JAR的完整路径。例如脚本中是否有CLASSPATH=$CLASSPATH:/your-app/lib/*这类配置。
• 启用类加载日志：在Nuix-REST启动参数中添加-verbose:class，启动后查看控制台输出，搜索com.hazelcast.zookeeper.ZookeeperDiscoveryStrategy类的加载记录。若出现Loaded com.hazelcast.zookeeper.ZookeeperDiscoveryStrategy from file:/your-app/lib/hazelcast-zookeeper.jar，说明JAR已被加载；无相关日志则表示不在classpath中。
• 编写测试类验证：创建一个简单Java类测试类加载：

  public class ClasspathValidator {
      public static void main(String[] args) {
          try {
              Class.forName("com.hazelcast.zookeeper.ZookeeperDiscoveryStrategy");
              System.out.println("hazelcast-zookeeper.jar 已在classpath中");
          } catch (ClassNotFoundException e) {
              System.out.println("hazelcast-zookeeper.jar 不在classpath中");
          }
      }
  }
  

  编译后，使用与Nuix-REST相同的classpath运行：java -cp /your-app/lib/*:. ClasspathValidator，根据输出判断结果。

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