Spring Boot容器化后无法读取docker-compose中Kafka brokers环境变量

你的问题核心是：Spring Boot应用打包成Docker镜像后，通过docker-compose启动时未正确读取KAFKA_BROKERS环境变量， fallback到默认的127.0.0.1:9092，导致无法连接Kafka容器。以下是针对性的排查和解决步骤：

1. 检查配置文件的变量绑定是否正确 #

• 打开application-prod.yml，确认Kafka地址配置是否正确使用了KAFKA_BROKERS占位符：

  spring:
    kafka:
      bootstrap-servers: ${KAFKA_BROKERS:localhost:9092}
  

  • 注意：如果占位符后带了默认值localhost:9092，当环境变量未正确传递时，应用会自动使用这个默认值，这就是你看到连接127.0.0.1:9092的原因。
  • 确保没有硬编码的localhost:9092配置，所有Kafka地址都通过环境变量注入。

2. 确认Docker Compose的环境变量传递配置 #

• 打开应用的docker-compose.yml，检查environment节点是否正确设置了KAFKA_BROKERS，并且值为Kafka容器的服务名（而非localhost）：

  services:
    your-app:
      image: your-app-image:latest
      environment:
        - SPRING_PROFILES_ACTIVE=prod  # 确保激活prod环境配置
        - KAFKA_BROKERS=kafka:9092     # 这里的kafka是Kafka容器在docker-compose中的服务名
      networks:
        - kafka-network  # 确保应用容器和Kafka容器在同一个网络下
  

  • 必须保证应用容器和Kafka容器处于同一个Docker网络，否则无法通过服务名通信。
  • 不要用localhost:9092，因为容器内的localhost指向自身，而非Kafka容器。

3. 验证Kafka容器的广告地址配置 #

• 打开Kafka的docker-compose.yml，确认KAFKA_ADVERTISED_LISTENERS配置正确，允许容器内部通信：

  kafka:
    image: wurstmeister/kafka:latest
    environment:
      KAFKA_ADVERTISED_LISTENERS: INSIDE://kafka:9092,OUTSIDE://localhost:9094
      KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: INSIDE:PLAINTEXT,OUTSIDE:PLAINTEXT
      KAFKA_LISTENERS: INSIDE://0.0.0.0:9092,OUTSIDE://0.0.0.0:9094
      KAFKA_INTER_BROKER_LISTENER_NAME: INSIDE
    networks:
      - kafka-network
  

  • INSIDE://kafka:9092是供Docker内部容器访问的地址，应用容器必须使用这个地址才能连接成功。

4. 检查Jib打包配置是否干扰环境变量 #

• 打开项目的pom.xml，查看Jib插件配置，确保没有硬编码Kafka地址或覆盖环境变量：

  <plugin>
    <groupId>com.google.cloud.tools</groupId>
    <artifactId>jib-maven-plugin</artifactId>
    <configuration>
      <!-- 确保这里没有设置environment节点硬编码KAFKA_BROKERS -->
      <container>
        <environment>
          <!-- 不要添加SPRING_KAFKA_BOOTSTRAP_SERVERS或KAFKA_BROKERS的硬编码值 -->
        </environment>
      </container>
    </configuration>
  </plugin>
  

  • Jib默认不会修改环境变量传递，但若配置了硬编码值，会覆盖docker-compose传递的变量。

5. 验证容器内环境变量是否存在 #

• 启动容器后，进入应用容器执行printenv命令，检查KAFKA_BROKERS是否存在：

  docker exec -it <your-app-container-id> printenv | grep KAFKA_BROKERS
  

  • 如果输出为空，说明docker-compose的环境变量配置有误，重新检查environment节点；
  • 如果输出正确，但应用仍连接127.0.0.1，说明Spring Boot未正确读取变量，检查配置文件的占位符是否正确，或是否激活了正确的profile。

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