Docker化Kafka实例启动及主机通过kafkacat连接失败求助

问题背景 #

• 在Debian 11主机machine1上通过Docker Compose部署了Bitnami官方的Kafka+ZooKeeper集群，容器运行状态正常
• 进入Kafka容器内部，可正常创建test-topic主题，且通过kafka-console-producer.sh、kafka-console-consumer.sh完成消息生产/消费
• 主机安装kafkacat后，执行kafkacat -L -t test-topic -b localhost:9092可正常获取主题元数据，但执行生产命令kafkacat -P -b localhost:9092 -t test-topic时，出现域名解析失败报错，无法解析容器hostname（如b56084cdd443:9092）

问题原因 #

核心是Kafka的**通告监听地址（advertised.listeners）**机制导致的：

1. Kafka内部会通过listeners配置监听服务端口，Bitnami容器默认使用自身容器hostname作为监听地址
2. 当客户端连接Kafka时，Kafka会将advertised.listeners配置的地址返回给客户端，作为后续生产/消费请求的实际连接地址
3. 当前未配置advertised.listeners，Kafka默认返回容器自身的hostname，而主机的DNS系统无法解析Docker容器的内部hostname，因此出现解析失败
4. kafkacat -L能成功是因为该命令仅需连接bootstrap服务器获取元数据，无需实际连接到broker节点；但生产/消费时必须使用返回的通告地址，因此触发报错

解决方案 #

修改Docker Compose配置，明确设置Kafka的监听地址和通告地址为主机能访问的地址：

1. 更新docker-compose.yml文件 #

修改Kafka服务的环境变量配置，新增KAFKA_CFG_LISTENERS和KAFKA_CFG_ADVERTISED_LISTENERS：

version: "2"

services:
  zookeeper:
    image: docker.io/bitnami/zookeeper:3.8
    ports:
      - "2181:2181"
    volumes:
      - "zookeeper_data:/bitnami"
    environment:
      - ALLOW_ANONYMOUS_LOGIN=yes
  kafka:
    image: docker.io/bitnami/kafka:3.4
    ports:
      - "9092:9092"
    volumes:
      - "kafka_data:/bitnami"
    environment:
      - KAFKA_CFG_ZOOKEEPER_CONNECT=zookeeper:2181
      - ALLOW_PLAINTEXT_LISTENER=yes
      # 新增配置：监听所有网卡的9092端口
      - KAFKA_CFG_LISTENERS=PLAINTEXT://0.0.0.0:9092
      # 新增配置：告知客户端用localhost:9092连接（若需外部机器访问，替换为主机实际IP）
      - KAFKA_CFG_ADVERTISED_LISTENERS=PLAINTEXT://localhost:9092
    depends_on:
      - zookeeper

volumes:
  zookeeper_data:
    driver: local
  kafka_data:
    driver: local

2. 重启Kafka集群 #

执行命令重启容器，使配置生效：

docker compose down
docker compose up -d

3. 验证功能 #

重启完成后，再次执行kafkacat -P -b localhost:9092 -t test-topic即可正常生产消息，消费命令也能正常工作。

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