容器化Spring Boot应用无法连接容器化Kafka问题求助

问题核心 #

非容器化状态下Spring Boot能正常连接容器化Kafka，但容器化后启动报错Couldn't resolve server kafka:9092，本质原因是Docker网络隔离：用docker-compose启动的Kafka/ZooKeeper默认会创建独立的专属网络，而Spring Boot容器加入的是techbankNet网络，两个网络之间没有连通性，导致Spring Boot容器无法通过kafka服务名解析到对应的容器IP。

解决方案 #

方案1：将Kafka/ZooKeeper加入Spring Boot所在的techbankNet网络 #

让所有需要通信的容器处于同一网络，是最直接的解决方式：

1. 确保techbankNet网络存在，不存在则创建：

docker network create techbankNet

2. 修改Kafka的docker-compose.yml，添加网络配置：

version: "3.4"

services:
  zookeeper:
    image: bitnami/zookeeper
    restart: always
    container_name: "zookeeper"
    ports:
      - "2181:2181"
    volumes:
      - "zookeeper_data:/bitnami"
    environment:
      - ALLOW_ANONYMOUS_LOGIN=yes
    networks:
      - techbankNet  # 加入目标网络
  kafka:
    image: bitnami/kafka
    ports:
      - "9092:9092"
    restart: always
    container_name: "kafka"
    volumes:
      - "kafka_data:/bitnami"
    environment:
      - KAFKA_ZOOKEEPER_CONNECT=zookeeper:2181
      - ALLOW_PLAINTEXT_LISTENER=yes
      - KAFKA_LISTENERS=PLAINTEXT://:9092
      - KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://kafka:9092
    depends_on:
      - zookeeper
    networks:
      - techbankNet  # 加入目标网络

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

networks:
  techbankNet:
    external: true  # 指定使用已存在的外部网络

3. 重启Kafka和ZooKeeper：

docker-compose down && docker-compose up -d

4. 简化Spring Boot容器启动命令（同一网络下无需--link，Docker会自动解析服务名）：

docker run --name project-service\
  --network techbankNet\ 
  -p 5001:5001\ 
  project-service

方案2：让Spring Boot容器同时加入自身网络和Kafka的默认网络 #

如果不想修改Kafka的网络配置，可以让Spring Boot容器跨网络访问：

1. 查看Kafka所在的docker-compose默认网络名：

docker network ls

通常网络名为你的docker-compose所在目录名加_default，比如kafka_project_default
2. 修改Spring Boot启动命令，同时加入两个网络：

docker run --name project-service\
  --network techbankNet\ 
  --network kafka_project_default\  # 替换为实际的Kafka网络名
  -p 5001:5001\ 
  project-service

关键注意事项 #

• 避免混用--link和自定义网络：Docker自定义网络已经提供了自动DNS解析功能，--link是旧特性，容易引发网络解析冲突。
• 确认所有需要通信的容器（MySQL、Mongo、Kafka、Spring Boot）都处于同一网络，这样服务名（如kafka、mysql-container）才能被正确解析。

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