以下是Zookeeper常见错误及解决方案：

1. 服务启动失败

   • 原因：端口冲突、配置文件错误、Java环境问题、权限不足。
   • 解决方案：
     • 检查端口占用：netstat -tulnp | grep 2181，修改zoo.cfg中clientPort或终止占用进程。
     • 确保zoo.cfg中dataDir路径正确且权限充足：chown -R zookeeper:zookeeper /path/to/dataDir。
     • 检查Java环境：java -version，设置JAVA_HOME并添加到PATH。
     • 清理临时文件：删除dataDir/version-2目录后重启。

2. 客户端连接问题

   • 原因：网络不通、防火墙拦截、配置参数错误。
   • 解决方案：
     • 测试网络连通性：ping服务器IP，telnet server-ip port。
     • 检查防火墙规则：开放Zookeeper端口（默认2181）：sudo firewall-cmd --add-port=2181/tcp --permanent。
     • 确认connectString和clientPort配置正确，客户端使用正确版本。

3. 会话过期（SessionExpired）

   • 原因：网络延迟、客户端心跳超时。
   • 解决方案：
     • 调整sessionTimeout参数（建议设置为集群tickTime的2-3倍）。
     • 客户端定期调用keepAlive方法维持会话，或重新创建Zookeeper实例。

4. 数据不一致

   • 原因：网络分区、节点故障导致数据同步失败。
   • 解决方案：
     • 使用sync()方法强制同步数据。
     • 定期备份数据目录和事务日志，异常时恢复。
     • 确保集群节点数为奇数（如3/5节点），避免脑裂。

5. 节点相关错误（NodeExists/NoNode）

   • NodeExists：尝试创建已存在节点，需先删除节点再重试。
   • NoNode：访问不存在的节点，检查路径正确性或确认节点是否被删除。

6. 性能问题（高延迟、低吞吐量）

   • 解决方案：
     • 优化硬件：使用SSD存储事务日志，增加内存。
     • 调整参数：增大tickTime（如2000ms），启用autopurge自动清理日志。
     • 分离数据目录与日志目录：设置dataLogDir参数。

7. 权限与安全问题

   • 原因：防火墙限制、SASL认证失败。
   • 解决方案：
     • 开放防火墙端口：sudo ufw allow 2181/tcp。
     • 配置SASL认证参数，确保客户端传入正确凭证。

排查工具：

• 日志分析：查看zookeeper.out或logs目录下的日志文件。
• 四字命令监控：echo stat | nc localhost 2181（需安装nc工具）。

参考来源：