Debian上Zookeeper常见问题与排查要点
一 服务无法启动与JAVA_HOME问题
- 现象：执行 systemctl 启动失败、控制台报 Error: JAVA_HOME is not set and java could not be found in PATH。
- 排查与处理：
- 确认已安装 Java 8+：执行 java -version；如未安装，使用 sudo apt-get install openjdk-8-jdk（或更高版本）。
- 正确设置 JAVA_HOME：编辑 /usr/local/zookeeper-*/bin/zkEnv.sh，加入例如：JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64；保存后重启。
- 查看服务与日志：systemctl status zookeeper；日志常见路径为 /var/log/zookeeper/zookeeper.out 或 /var/log/zookeeper/zookeeper.log。
二 配置与集群身份问题
- 现象：集群无法选主、节点不停重连、myid 不匹配。
- 排查与处理：
- 核对 /etc/zookeeper/conf/zoo.cfg 关键项：tickTime、initLimit、syncLimit、dataDir、clientPort，以及集群行 server.X=host:2888:3888（X 为节点编号）。
- 在 dataDir 下放置 myid 文件，内容必须与该节点的 server.X 编号严格一致（如 server.1 对应 myid=1）。
- 权限与路径：确保 dataDir 及父目录属 zookeeper 用户，目录存在且可写。
- 变更后重启：systemctl restart zookeeper。
三 端口与网络连通性问题
- 现象：客户端连不上 2181，集群节点间握手失败（常见于 2888/3888）。
- 排查与处理：
- 检查端口占用：netstat -tulpen | grep -E ‘2181|2888|3888’，如被占用，释放或调整端口后重启。
- 本机连通性：echo stat | nc localhost 2181；远程连通性：nc -vz 目标IP 2181。
- 防火墙放行：Debian 常见为 ufw 或 iptables；例如 sudo ufw allow 2181,2888,3888/tcp，或按需配置 iptables 规则。
- 云环境需同时检查 安全组 策略。
四 日志、资源与版本兼容性问题
- 现象：磁盘被日志打满、查询变慢、偶发超时或异常退出。
- 排查与处理：
- 日志轮转与清理：监控 /var/log/zookeeper/ 大小，配置 log4j 滚动策略，定期归档/清理，避免磁盘占满。
- 资源瓶颈：用 top/htop 观察 CPU/内存/IO，必要时扩容或限流。
- 连接数限制：在 zoo.cfg 调整 maxClientCnxns（如 500），缓解 “too many connections from host”。
- 版本兼容：确保 客户端与服务端版本匹配；Debian 稳定版搭配 ZooKeeper 3.4.x/3.7.x 等稳定分支更稳妥，跨大版本升级需按官方文档进行。
五 快速排查清单
- 查看服务与日志：systemctl status zookeeper；tail -f /var/log/zookeeper/*.log。
- 校验配置与身份：cat /etc/zookeeper/conf/zoo.cfg；cat $dataDir/myid。
- 端口与连通：ss -lntp | grep -E ‘2181|2888|3888’；echo stat | nc localhost 2181；nc -vz IP 2181。
- Java 环境：java -version；echo $JAVA_HOME；必要时在 zkEnv.sh 中显式设置。
- 防火墙/安全组：sudo ufw status；按需放行 2181/2888/3888。
- 变更后重启并观察：systemctl restart zookeeper；持续 tail 日志确认恢复。
