CentOS上Zookeeper故障排查步骤

1. 检查Zookeeper服务运行状态

使用systemctl命令确认Zookeeper服务是否处于运行状态：

sudo systemctl status zookeeper

若服务未启动，执行以下命令启动服务并设置开机自启：

sudo systemctl start zookeeper    # 启动服务
sudo systemctl enable zookeeper   # 设置开机自启

通过状态输出可快速判断服务是否正常启动，若存在失败提示，需结合日志进一步分析。

2. 分析Zookeeper日志文件

Zookeeper的日志默认存储在/var/log/zookeeper/目录下（核心日志文件为zookeeper.out），通过查看日志可定位具体错误原因：

tail -f /var/log/zookeeper/zookeeper.out  # 实时查看最新日志

重点关注日志中的错误级别（ERROR/WARN）、时间戳及具体报错信息（如配置缺失、端口冲突、权限不足等），这是故障排查的关键依据。

3. 核对ZooKeeper配置文件

Zookeeper的主配置文件为/etc/zookeeper/conf/zoo.cfg（部分安装路径可能为/your-zookeeper-path/conf/zoo.cfg），需检查以下关键参数：

dataDir：数据存储目录是否存在，且Zookeeper进程有写入权限（如mkdir -p /var/lib/zookeeper && chown -R zookeeper:zookeeper /var/lib/zookeeper）；
clientPort：客户端连接端口（默认2181）是否被其他进程占用；
server.x：集群节点配置是否正确（格式为server.x=主机名:2888:3888，其中x为节点ID，需与dataDir下的myid文件内容一致）。

4. 验证Java环境

Zookeeper依赖Java 1.8及以上版本，需检查Java是否安装及版本是否符合要求：

java -version  # 查看Java版本

若未安装，使用以下命令安装OpenJDK 8：

sudo yum install java-1.8.0-openjdk-devel -y

同时确认JAVA_HOME环境变量已正确设置（如export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk，并添加至~/.bash_profile）。

5. 检查防火墙及端口连通性

确保防火墙未阻止Zookeeper的默认端口（2181）：

# 查看防火墙规则
sudo firewall-cmd --list-all
# 开放2181端口（永久生效）
sudo firewall-cmd --zone=public --add-port=2181/tcp --permanent
sudo firewall-cmd --reload

若需临时关闭防火墙测试（不推荐生产环境），可执行：

sudo systemctl stop firewalld

此外，使用telnet或nc命令测试节点间网络连通性（如telnet <节点IP> 2181）。

6. 使用四字命令诊断集群状态

Zookeeper提供了一系列四字命令（需通过nc或telnet工具调用），用于监控集群状态：

# 查看集群状态（需替换为实际节点IP）
echo stat | nc localhost 2181
echo ruok | nc localhost 2181  # 返回"imok"表示服务正常
echo mntr | nc localhost 2181  # 查看详细监控指标（如节点角色、延迟等）

通过四字命令可快速判断集群是否正常运行（如Leader节点是否存在、Follower是否同步）。

7. 检查数据目录与日志完整性

Zookeeper的数据目录（dataDir）和日志目录（logs）存储了集群的关键数据，若数据损坏可能导致启动失败：

备份旧数据（如mv /var/lib/zookeeper /var/lib/zookeeper.bak）；
删除旧版本目录（如rm -rf /var/lib/zookeeper/version-2、rm -rf /var/log/zookeeper/version-2）；
重启Zookeeper服务以重建数据目录：

sudo systemctl restart zookeeper

注意：此操作会清除旧数据，仅能在测试环境或确认数据可丢失时使用。

8. 重启Zookeeper服务

若上述步骤均已排查完毕，可尝试重启Zookeeper服务以应用更改：

sudo systemctl restart zookeeper

重启后再次检查服务状态及日志，确认故障是否解决。

通过以上步骤可系统化排查CentOS上Zookeeper的常见故障（如服务未启动、配置错误、端口冲突、权限问题等）。若问题仍未解决，建议参考Zookeeper官方文档或社区论坛获取进一步支持。

CentOS上Zookeeper故障排查步骤