一、基础环境与服务状态检查
systemctl status kafka确认Kafka服务是否处于active (running)状态;若未启动,执行systemctl start kafka并观察启动日志(journalctl -u kafka -f)中的错误信息。同时检查Zookeeper服务(Kafka依赖其实现集群管理),确保systemctl status zookeeper显示正常。server.properties中通过listeners配置调整),通过netstat -tuln | grep 9092或ss -tuln | grep 9092检查端口是否被Kafka进程占用;若端口被占用,需修改server.properties中的listeners配置(如改为9093)或停止占用进程。此外,使用telnet <kafka_broker_ip> 9092测试客户端与Broker的网络连通性,确保防火墙未阻止该端口(通过firewall-cmd --list-ports查看开放端口,必要时添加firewall-cmd --add-port=9092/tcp --permanent && firewall-cmd --reload)。二、配置文件准确性核查
重点检查server.properties(通常位于/etc/kafka/或Kafka安装目录下)中的关键配置:
broker.id:集群中每个Broker的ID必须唯一,禁止重复;log.dirs:日志目录(如/var/lib/kafka)需存在且具备读写权限(chown -R kafka:kafka /var/lib/kafka);zookeeper.connect:Zookeeper集群地址需正确(如localhost:2181或zk1:2181,zk2:2181,zk3:2181),且Zookeeper服务正常;advertised.listeners:需指向客户端可访问的Broker地址(如PLAINTEXT://<公网IP>:9092),避免因地址不可达导致连接失败。三、日志与错误信息分析
Kafka的日志文件(默认位于/var/log/kafka/或logs/目录下)是故障排查的核心依据。启动失败时,重点查看server.log中的ERROR或FATAL级别日志:
java.net.BindException: Address already in use,说明端口冲突;No such file or directory: /var/lib/kafka,说明日志目录不存在或权限不足;Connection refused,说明Zookeeper服务未启动或网络不通。根据日志中的具体错误信息针对性解决。四、硬件资源监控 使用系统工具检查Kafka所在服务器的资源使用情况:
top或htop查看CPU使用率,若长期超过80%,可能需要优化分区数(增加并行度)或升级CPU;free -m查看内存剩余量,Kafka的JVM堆内存(-Xmx/-Xms)建议设置为物理内存的1/4-1/2(避免过大导致GC频繁);df -h查看磁盘空间(log.dirs所在分区需预留20%以上空间),使用iostat -x 1查看磁盘I/O延迟(若await值过高,建议更换SSD);iftop或nload查看网络带宽使用率,若带宽占用超过80%,可能需要升级网络设备或优化数据传输量。五、Zookeeper状态检查
Kafka依赖Zookeeper存储集群元数据(如Broker信息、分区副本状态)。使用zkCli.sh(Zookeeper自带客户端)连接到Zookeeper集群(./zkCli.sh -server <zk_ip>:2181),执行以下命令检查状态:
ls /brokers/ids:查看集群中的Broker列表,若列表为空或Broker数量不足,说明Broker未正确注册;ls /brokers/topics:查看已创建的Topic列表,确认Topic状态正常。若Zookeeper出现异常(如节点断开、数据不一致),需重启Zookeeper服务(systemctl restart zookeeper)或修复数据。六、常见场景故障解决
log.dirs和data目录下的内容(需备份重要数据),再重新启动;java -version确认Java版本符合Kafka要求(建议使用Java 8或11),并确保JAVA_HOME环境变量设置正确。kafka-consumer-groups.sh --bootstrap-server <broker_ip>:9092 --describe查看Lag值),可采取以下措施:
num.consumer.fetchers设置为大于1的值,或增加消费者实例);df -h显示磁盘空间不足,需清理旧日志(如删除/var/log/kafka/中超过7天的日志文件),或扩展磁盘空间(如挂载新磁盘并将log.dirs指向新目录)。