SpringBoot Kafka消费者始终尝试连接127.0.0.1:9092求助

一、核心问题：Kafka对外暴露地址配置错误 #

Kafka默认会把容器内部的地址返回给客户端，导致你的SpringBoot消费者拿到的是127.0.0.1:9092而非外部可访问的pepito:8484。必须修改Kafka容器的以下关键配置：

• KAFKA_LISTENERS：指定Kafka在容器内部监听的地址，设置为PLAINTEXT://0.0.0.0:9092，允许容器内所有地址访问
• KAFKA_ADVERTISED_LISTENERS：这是解决问题的核心，要设置成外部客户端能访问到的地址，即PLAINTEXT://pepito:8484
• KAFKA_LISTENER_SECURITY_PROTOCOL_MAP：明确协议映射，设置为PLAINTEXT:PLAINTEXT

Docker Run启动示例 #

docker run -d \
  --name kafka \
  -p 8484:9092 \
  -e KAFKA_BROKER_ID=1 \
  -e KAFKA_ZOOKEEPER_CONNECT=zookeeper:2181 \ # 替换为你的ZooKeeper地址
  -e KAFKA_LISTENERS=PLAINTEXT://0.0.0.0:9092 \
  -e KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://pepito:8484 \
  -e KAFKA_LISTENER_SECURITY_PROTOCOL_MAP=PLAINTEXT:PLAINTEXT \
  -e KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR=1 \
  apache/kafka:3.7.1

Docker Compose配置示例 #

version: '3'
services:
  kafka:
    image: apache/kafka:3.7.1
    ports:
      - "8484:9092"
    environment:
      KAFKA_BROKER_ID: 1
      KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181 # 对应你的ZooKeeper服务名或地址
      KAFKA_LISTENERS: PLAINTEXT://0.0.0.0:9092
      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://pepito:8484
      KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: PLAINTEXT:PLAINTEXT
      KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1

二、SpringBoot端检查事项 #

• 确认spring.kafka.bootstrap-servers确实配置为pepito:8484，没有被环境变量、配置中心等其他配置覆盖
• 检查当前激活的SpringBoot配置文件是否正确应用了该地址

三、验证配置是否生效 #

进入Kafka容器，用自带工具查看配置：

docker exec -it kafka /bin/bash
kafka-configs.sh --describe --bootstrap-server localhost:9092 --entity-type brokers --entity-name 1

输出中如果能看到advertised.listeners=PLAINTEXT://pepito:8484，说明配置已生效。

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