Zookeeper故障排查Ubuntu版怎么办

Ubuntu 上 Zookeeper 故障排查清单

一 快速定位与常用命令

• 查看进程与端口
  • 进程：运行 jps，确认是否存在 QuorumPeerMain；如存在但状态异常，先记录 PID 再排查。
  • 端口：运行 sudo netstat -lnp | grep 2181（或 grep 你配置的 clientPort），确认端口是否被占用或监听异常。
• 前台启动与日志
  • 前台启动：在 bin/ 下执行 ./zkServer.sh start-foreground，可直接看到启动期异常堆栈。
  • 日志路径：检查 $ZOOKEEPER_HOME/logs/ 下的 .out 与 zookeeper-*.log，优先从日志定位根因。
• 服务管理
  • 启动：./zkServer.sh start
  • 状态：./zkServer.sh status
  • 停止：./zkServer.sh stop
• 环境校验
  • 确认 JAVA_HOME 已设置且 java 在 PATH 中；Zookeeper 启动脚本会先读取 JAVA_HOME。

二 常见故障与修复对照表

三 关键配置检查

• 配置文件与目录
  • 使用 conf/zoo.cfg，确认 dataDir 与 dataLogDir 指向已存在且可写的目录；若配置了日志目录，需提前 mkdir -p 创建。
• myid 一致性
  • 在 dataDir 下创建 myid，各节点值必须唯一（如 1、2、3），且与 server.x 的对应关系一致。
• 客户端端口
  • 确认 clientPort（默认 2181）未被占用；如冲突，修改为未使用端口并重启。
• 主机名与解析
  • zoo.cfg 中的主机名必须可解析；建议检查 /etc/hosts 的 IP<->主机名 映射，必要时先用 IP 替代主机名验证连通性。

四 网络连通性检查

• 本机监听
  • 运行 netstat -lnp | grep 2181，确认本机已在 0.0.0.0:2181 或指定地址监听，而非仅 127.0.0.1。
• 节点间访问
  • 在每台机器上测试：nc -vz <目标IP> 2181 或 telnet <目标IP> 2181，确保集群各节点间 2181 端口可达。
• Ubuntu 防火墙
  • 查看：sudo ufw status
  • 临时关闭：sudo ufw disable
  • 如需放行：sudo ufw allow 2181/tcp（或按你的端口调整）

五 一键排查脚本示例

#!/usr/bin/env bash
set -e

echo "=== 1) Java 与 JAVA_HOME ==="
if [ -z "$JAVA_HOME" ]; then
  echo "JAVA_HOME 未设置，请先 export JAVA_HOME=/your/jdk/path"
  exit 1
fi
"$JAVA_HOME/bin/java" -version

echo "=== 2) 进程与端口 ==="
jps | grep -E 'QuorumPeerMain|Jps'
sudo netstat -lnp | grep -E '2181|clientPort'

echo "=== 3) 前台启动看错误 ==="
cd "$ZOOKEEPER_HOME/bin"
./zkServer.sh start-foreground

# 如前台启动成功但后台异常，再回到脚本开头逐项检查

• 使用方式：保存为 zk-debug.sh，赋权 chmod +x zk-debug.sh，在 $ZOOKEEPER_HOME 下执行。