核心故障原因 #

错误信息明确提示advertised listeners cannot be empty，根源在于Kafka服务的环境变量配置错误：KAFKA_PROCESS_ROLES: ""。

Confluent CP Kafka镜像的新版本中，KAFKA_PROCESS_ROLES用于指定节点角色（如broker、controller），若设置该参数为空值，会触发内部配置逻辑异常，导致监听器配置无法正常加载，进而提示“advertised listeners不能为空”。

修复步骤 #

1. 修改Docker Compose文件 #

移除Kafka服务中的KAFKA_PROCESS_ROLES: ""配置项，单节点场景下无需设置该参数，或明确指定角色为broker。

修改后的Kafka服务环境变量片段：

kafka:
  image: confluentinc/cp-kafka:latest
  privileged: true
  ports:
    - 9200:9200
  networks:
    - kafka-net
  depends_on:
    - zookeeper
  environment:
    KAFKA_BROKER_ID: 1
    KAFKA_CFG_ZOOKEEPER_CONNECT: zookeeper:3181
    KAFKA_CFG_LISTENERS: INTERNAL://0.0.0.0:9100,OUTSIDE://0.0.0.0:9200
    KAFKA_CFG_ADVERTISED_LISTENERS: INTERNAL://kafka:9100,OUTSIDE://localhost:9200
    KAFKA_CFG_LISTENER_SECURITY_PROTOCOL_MAP: INTERNAL:PLAINTEXT,OUTSIDE:PLAINTEXT
    KAFKA_CFG_INTER_BROKER_LISTENER_NAME: INTERNAL
    KAFKA_CFG_OFFSETS_TOPIC_REPLICATION_FACTOR: 1
    KAFKA_CFG_MESSAGE_MAX_BYTES: 20485760
    # 移除无效的空值配置项
    # KAFKA_PROCESS_ROLES: ""

2. 清理旧容器并重新部署 #

执行以下命令清理异常容器并重启服务：

# 停止并移除现有容器
podman-compose down
# 重新启动服务
podman-compose up -d

3. 验证服务状态 #

检查Kafka容器是否正常运行：

podman-compose ps

若Kafka状态显示“运行中”，再通过Kafdrop访问http://localhost:9992/kafkaui验证Kafka连接状态。

额外注意事项 #

• Zookeeper端口配置：Compose中设置了ZOOKEEPER_CLIENT_PORT: 3181，容器内部通信使用该端口，当前Kafka的Zookeeper连接配置zookeeper:3181是正确的，无需额外修改端口映射。
• depends_on仅保证启动顺序，不保证服务就绪，若需等待Zookeeper完全就绪后再启动Kafka，可添加健康检查配置。

内容的提问来源于stack exchange，提问作者Chandan Mahadev Shetty