Zookeeper作为分布式系统的核心协调服务，其稳定运行依赖于正确的配置、网络环境和资源保障。以下是针对CentOS环境的系统性故障排查步骤及解决方法：
首先确认Zookeeper服务是否处于运行状态，使用以下命令查看服务状态：
sudo systemctl status zookeeper 若服务未启动，可通过以下命令启动并设置开机自启：
sudo systemctl start zookeeper # 启动服务 sudo systemctl enable zookeeper # 设置开机自启 服务启动失败时，需结合日志进一步分析原因。
Zookeeper的日志是故障排查的核心线索，默认日志路径为/var/log/zookeeper/zookeeper.out。使用以下命令实时查看日志末尾内容（重点关注ERROR或WARN级别信息）：
tail -f /var/log/zookeeper/zookeeper.out 若日志文件过大，可通过less或grep命令筛选关键信息（如tail -n 100 /var/log/zookeeper/zookeeper.out查看最近100行）。
Zookeeper的主配置文件为/etc/zookeeper/conf/zoo.cfg，需检查以下关键参数：
dataDir：数据存储目录是否存在，且Zookeeper进程有写入权限（可通过ls -ld /var/lib/zookeeper验证权限）；server.x：集群节点配置是否正确（格式为server.id=host:port1:port2，其中id为节点唯一标识）；clientPort：客户端连接端口（默认2181）是否被占用（可通过netstat -tuln | grep 2181检查）；tickTime/initLimit/syncLimit：心跳时间、Leader选举超时等参数是否符合集群规模需求（如tickTime=2000表示心跳间隔2秒）。此外，需确保每个节点的myid文件（位于dataDir目录下）内容与zoo.cfg中的server.x编号一致（如server.1对应myid文件内容为1）。
Zookeeper集群要求节点间网络互通，使用以下命令测试节点间连通性（以zk1为例）：
ping zk1 # 测试网络可达性 telnet zk1 2181 # 测试端口连通性（若未安装telnet，可通过`yum install telnet`安装） 若端口不通，需调整防火墙规则：
sudo firewall-cmd --zone=public --add-port=2181/tcp --permanent # 开放2181端口 sudo firewall-cmd --reload # 重新加载防火墙配置 若使用iptables，需添加对应规则（如iptables -A INPUT -p tcp --dport 2181 -j ACCEPT）。
Zookeeper内置的四字命令可快速获取集群运行状态，常用命令如下：
ruok：检查服务是否正常运行（返回imok表示正常）；stat：查看服务器状态（包括角色、客户端数量、Zxid等）；mntr：获取详细的监控指标（如Leader/Follower数量、事务处理量、延迟等）；cons：查看客户端连接信息（包括IP、延迟、请求队列长度）。通过nc命令执行四字命令（以localhost为例）：
echo stat | nc localhost 2181 # 查看服务器状态 echo mntr | nc localhost 2181 # 获取监控指标 若命令返回Connection refused，说明服务未启动或端口未开放。
Zookeeper依赖Java运行环境（推荐使用OpenJDK 8或11），使用以下命令检查Java版本：
java -version 若未安装或版本不兼容，可通过以下命令安装OpenJDK 8：
sudo yum install java-1.8.0-openjdk-devel # 安装Java 8 安装后需配置JAVA_HOME环境变量（在/etc/profile中添加export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk并执行source /etc/profile）。
Zookeeper是内存密集型应用，资源不足会导致服务崩溃或性能下降。使用以下命令查看系统资源：
top # 查看CPU、内存使用率 df -h # 查看磁盘空间（确保`dataDir`所在分区有足够空间） iostat -x 1 # 查看磁盘I/O性能（若I/O等待过高，需更换SSD磁盘） 若内存不足，可调整JVM堆大小（在zoo.cfg中添加JVMFLAGS="-Xms1g -Xmx1g"，限制堆内存为1GB）。
OutOfMemoryError表示内存不足，DiskFull表示磁盘空间不足），调整资源或修复磁盘；Follower同步失败的记录，检查Leader节点性能（如CPU占用过高）或网络延迟（如节点间延迟超过100ms）；sudo yum install ntp，并配置/etc/ntp.conf同步公共NTP服务器），或从健康节点恢复数据。通过以上步骤，可覆盖CentOS环境下Zookeeper的常见故障场景。若问题仍未解决，建议查阅Zookeeper官方文档（如故障排查指南）或寻求社区支持。
