Docker Swarm同栈SpringBoot3连接Kafka报bootstrap.servers不可解析错误求助

核心问题根源 #

1. 容器名与Swarm服务名混淆：你使用的kafka-1是Swarm动态生成的容器实例名，而非服务的稳定标识。Swarm服务间的DNS解析仅支持服务名称（即docker-compose.yml里services下定义的名称），容器名会随服务扩容/重启变化，不能作为可靠连接地址。
2. Kafka公告地址配置错误：apache/kafka官方镜像默认的advertised.listeners设为PLAINTEXT://localhost:9092。当SpringBoot通过Swarm网络连接到Kafka的29092端口后，Kafka会把这个localhost:9092地址返回给客户端作为后续通信地址——但该地址在SpringBoot容器内部指向自身，根本无法访问到Kafka服务，因此出现“能建立连接但无响应”的现象。

具体修复步骤 #

1. 修正Kafka服务的Docker Compose配置 #

在Swarm栈的docker-compose.yml中，给Kafka服务添加环境变量，指定正确的监听地址和公告地址：

services:
  kafka:
    image: apache/kafka:latest
    environment:
      # 配置Kafka监听的内部（Swarm网络）和外部端口
      KAFKA_LISTENERS: PLAINTEXT://0.0.0.0:29092,PLAINTEXT_HOST://0.0.0.0:9092
      # 关键：公告地址设为Swarm服务名+内部端口，让客户端能获取正确通信地址
      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://kafka:29092,PLAINTEXT_HOST://localhost:9092
      KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: PLAINTEXT:PLAINTEXT,PLAINTEXT_HOST:PLAINTEXT
      KAFKA_INTER_BROKER_LISTENER_NAME: PLAINTEXT
      # 若用ZooKeeper模式需添加此配置，KRaft模式则替换为对应KRaft变量
      KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181
    networks:
      - your-overlay-network # 替换为你实际的overlay网络名称
    # 按需添加deploy、volumes等配置

  springboot-app:
    image: your-springboot-image:latest
    environment:
      # 用Swarm Kafka服务名+内部端口作为bootstrap地址
      SPRING_KAFKA_BOOTSTRAP_SERVERS: kafka:29092
    networks:
      - your-overlay-network
    # 按需添加其他配置

注：若使用Kafka 2.8+的KRaft模式（无需ZooKeeper），需添加KRaft相关配置：KAFKA_NODE_ID=1、KAFKA_PROCESS_ROLES=broker,controller、KAFKA_CONTROLLER_QUORUM_VOTERS=1@kafka:9093，同时调整KAFKA_LISTENERS包含CONTROLLER://0.0.0.0:9093。

2. 修正SpringBoot的Kafka配置 #

确保SpringBoot的配置文件（application.properties或application.yml）中，bootstrap地址指向Swarm Kafka服务名：

# application.properties
spring.kafka.bootstrap-servers=kafka:29092

或YAML格式：

# application.yml
spring:
  kafka:
    bootstrap-servers: kafka:29092

禁止使用容器名（如kafka-1），避免服务扩容后连接失效。

3. 验证配置有效性 #

• 进入SpringBoot容器执行nslookup kafka，确认能解析到Kafka服务的集群IP。
• 进入Kafka容器查看/opt/kafka/config/server.properties，确认advertised.listeners已设为PLAINTEXT://kafka:29092。

额外注意事项 #

• 多节点Swarm集群中，确保Kafka服务的deploy配置无限制跨节点部署的规则，overlay网络默认支持跨节点通信。
• 除非仅做单容器测试，否则禁止在Kafka配置中使用localhost作为公告地址。

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