Zookeeper在CentOS上的常见故障及解决方案

一、服务未运行

• 现象：Zookeeper服务无法启动或停止。
• 解决方案：
  • 检查服务状态：sudo systemctl status zookeeper。
  • 启动服务：sudo systemctl start zookeeper，设置开机自启：sudo systemctl enable zookeeper。

二、端口占用

• 现象：服务启动失败，提示端口被占用（默认2181）。
• 解决方案：
  • 查看占用进程：netstat -tuln | grep 2181 或 ss -tuln | grep 2181。
  • 杀掉占用进程或修改zoo.cfg中clientPort为其他端口。

三、配置文件错误

• 现象：服务启动报错，提示配置参数异常。
• 解决方案：
  • 检查zoo.cfg文件语法及参数（如dataDir、clientPort、server.x等）是否正确。
  • 确保dataDir目录存在且权限正确：chown -R zookeeper:zookeeper /path/to/dataDir，chmod -R 750 /path/to/dataDir。
  • 验证myid文件内容与zoo.cfg中server.x配置一致。

四、Java环境问题

• 现象：启动时提示JAVA_HOME未设置或版本不兼容。
• 解决方案：
  • 安装JDK 8+：sudo yum install java-1.8.0-openjdk。
  • 设置环境变量：在~/.bash_profile中添加export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk，并执行source ~/.bash_profile。

五、防火墙限制

• 现象：集群节点间无法通信。
• 解决方案：
  • 开放Zookeeper端口（默认2181）：sudo firewall-cmd --zone=public --add-port=2181/tcp --permanent，sudo firewall-cmd --reload。

六、资源不足

• 现象：服务运行缓慢或异常退出。
• 解决方案：
  • 使用top、free等命令检查CPU、内存、磁盘使用情况。
  • 优化配置参数（如tickTime、initLimit）或升级硬件。

七、网络问题

• 现象：节点间通信超时或丢包。
• 解决方案：
  • 使用ping或telnet测试节点间连通性。
  • 检查服务器网络配置（如IP、子网掩码、网关）。

八、日志分析

• 现象：无法定位故障原因。
• 解决方案：
  • 查看日志文件（默认路径/var/log/zookeeper/或/path/to/zookeeper/logs/），重点关注ERROR和WARN级别日志。
  • 使用tail -n 100 zookeeper.out快速查看最新日志。

九、集群状态异常

• 现象：Leader频繁切换或节点失联。
• 解决方案：
  • 使用四字命令监控集群状态：echo stat | nc localhost 2181（需安装nc工具）。
  • 检查网络延迟和磁盘I/O，确保节点性能均衡。

参考来源：