Apache Kafka单节点Docker部署：如何配置监听器以使用Docker主机名

嘿，这个问题我碰到过！当你手动配置监听器环境变量时，确实会触发Kafka Docker镜像的一个小“坑”——它会默认切换回Zookeeper模式，而不是保留原来的Kraft配置。我来给你拆解一下原因和解决办法：

问题根源 #

官方的Apache Kafka Docker镜像默认会自动配置Kraft单节点模式，但当你手动设置KAFKA_LISTENERS、KAFKA_ADVERTISED_LISTENERS这类核心配置变量时，会覆盖镜像的默认Kraft初始化逻辑，导致Kafka认为你要切换到Zookeeper模式，所以才会报错提示缺少zookeeper.connect配置。

解决方案：同时保留Kraft和监听器配置 #

要让Kafka继续使用Kraft模式，同时配置自定义监听器，你需要显式指定Kraft模式的核心环境变量，再结合监听器配置一起运行。这里给你一个完整的docker命令：

docker run --network=internal --name my-kafka \
  -e KAFKA_NODE_ID=1 \
  -e KAFKA_PROCESS_ROLES=broker,controller \
  -e KAFKA_CONTROLLER_QUORUM_VOTERS=1@my-kafka:9093 \
  -e KAFKA_LISTENERS=PLAINTEXT://my-kafka:9092,CONTROLLER://my-kafka:9093 \
  -e KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://my-kafka:9092 \
  -e KAFKA_LISTENER_SECURITY_PROTOCOL_MAP=PLAINTEXT:PLAINTEXT,CONTROLLER:PLAINTEXT \
  -e KAFKA_CONTROLLER_LISTENER_NAMES=CONTROLLER \
  -e KAFKA_INTER_BROKER_LISTENER_NAME=PLAINTEXT \
  apache/kafka:3.7.0

关键变量解释：

• KAFKA_NODE_ID: Kraft模式下每个节点的唯一标识，单节点设为1即可
• KAFKA_PROCESS_ROLES: 指定该节点同时承担broker（处理消息）和controller（集群管理）角色，单节点模式必须这么设置
• KAFKA_CONTROLLER_QUORUM_VOTERS: Controller集群的投票节点列表，这里单节点就是1@my-kafka:9093（对应CONTROLLER监听器的地址）
• KAFKA_LISTENERS: 定义Kafka监听的所有端口，包含业务用的PLAINTEXT和controller内部通信的CONTROLLER
• KAFKA_ADVERTISED_LISTENERS: 对外公布的客户端连接地址，也就是你需要的my-kafka:9092
• KAFKA_CONTROLLER_LISTENER_NAMES: 指定controller内部通信使用的监听器名称
• KAFKA_INTER_BROKER_LISTENER_NAME: 指定broker之间通信使用的监听器名称

验证配置是否生效 #

启动容器后，查看日志：

1. 确认没有zookeeper.connect相关的错误
2. 找到类似以下的日志，说明监听器配置正确：

   INFO [KafkaServer id=1] started (kafka.server.KafkaServer)
   INFO [BrokerServer id=1] Started 1 acceptor threads for listener 'PLAINTEXT' (kafka.network.ListenerAcceptor)
   

3. 客户端使用my-kafka:9092作为bootstrap地址，应该能正常连接并发送/接收消息了

备注：内容来源于stack exchange，提问作者Snappawapa