kafka-under-replicated

Kafka 分区副本不足的定位与修复

现象

监控显示 UnderReplicatedPartitions 大于 0，部分分区 ISR 数量低于副本因子。写入可能变慢，副本因子不足时存在数据丢失风险。

快速定位

kafka-topics --bootstrap-server broker:9092 \
  --describe --under-replicated-partitions
kafka-topics --bootstrap-server broker:9092 --describe --topic app-events
kafka-broker-api-versions --bootstrap-server broker:9092

broker 侧：

journalctl -u kafka --since '30 min ago' | tail -100
df -h

常见根因

1. broker 下线、重启或网络分区。
2. 副本拉取慢：磁盘 I/O、网络带宽或 replica.fetch.max.bytes 限制。
3. ISR 超时：replica.lag.time.max.ms 与负载不匹配。
4. 磁盘满、文件系统只读或 broker 进程异常。
5. 控制器/元数据异常，副本分配未完成。

修复

• 先恢复异常 broker，确认进程、磁盘、网络和日志。
• 检查 ISR 收缩时间点，区分单 broker 故障和全局负载。
• 提升磁盘/网络，调整副本拉取和 ISR 超时参数。
• 副本因子不足的分区用 kafka-reassign-partitions 重新分配。
• 避免在高峰期做大量分区重分配。
• 监控 ISR、UnderReplicatedPartitions 和磁盘使用率。

相关命令

• kafka-topics — 分区与副本
• kcat — 消费验证
• kafka-consumer-groups — 消费状态