Kafka移除Broker后重启失败：配置投票集与状态文件不一致问题处理

从Kafka集群中移除ID为2的Broker后，其余Broker无法重启，server.log报错如下：

ERROR [SharedServer id=1] Got exception while starting SharedServer (kafka.server.SharedServer)
java.lang.IllegalStateException: Configured voter set: [1, 3] is different from the voter set
read from the state file: [1, 2, 3]. Check if the quorum configuration is up to date, or wipe out the
local state file if necessary

疑问解答 #

1. 本地状态文件的位置与具体文件 #

• 该文件是Kafka投票集群的本地状态存储文件，路径取决于部署模式：
  • KRaft模式：位于${log.dirs}/quorum-state/raft-state，其中log.dirs是server.properties中配置的Kafka数据存储目录。
  • ZooKeeper模式：对应${log.dirs}/meta.properties文件，用于存储Broker元数据信息。
    你的报错更偏向KRaft模式下的投票集不匹配问题，优先检查raft-state文件。

2. 错误修复方案 #

• 优先确认配置是否完全更新，不要直接删除状态文件：
  1. 检查所有剩余Broker的server.properties，确保controller.quorum.voters已设置为[1,3]，无ID为2的节点残留；同时确认node.id和process.roles配置正确。
  2. 若配置无误仍报错，再操作状态文件：
     • 停止报错的Broker进程。
     • 找到对应路径下的状态文件（KRaft模式找raft-state，ZK模式找meta.properties），先备份再删除原文件。
     • 重启Broker，它会从集群同步最新投票集配置，自动重建本地状态文件。
• 注意：删除状态文件前必须备份，且确保集群中有正常运行的节点提供最新配置，避免集群分裂或数据丢失。

内容的提问来源于stack exchange，提问作者user2138149