Docker化Spring Boot应用启动时遇RabbitMQ Stream Exception问题

问题现象 #

启动Docker化Spring Boot应用时触发报错：

未能启动bean 'org.springframework.amqp.rabbit.config.internalRabbitListenerEndpointRegistry'；嵌套异常为com.rabbitmq.stream.StreamException。错误根源为：java.net.UnknownHostException: 4e31343111e9: Temporary failure in name resolution

已知背景：

• RabbitMQ认证正常（修改凭据会在更早阶段报错）
• Spring Boot与RabbitMQ分别运行在不同主机的Docker容器中
• RabbitMQ已开放5552端口

解决方案 #

• 修正RabbitMQ连接地址配置
  错误中的4e31343111e9是RabbitMQ容器的ID，跨主机场景下其他容器无法解析这个标识。必须将Spring Boot配置中的RabbitMQ主机地址替换为RabbitMQ所在主机的真实IP或可被DNS解析的主机名。
  示例配置：

  # application.properties
  spring.rabbitmq.host=192.168.1.100  # 替换为RabbitMQ主机的实际IP
  spring.rabbitmq.port=5552
  spring.rabbitmq.username=your-username
  spring.rabbitmq.password=your-password
  

  # application.yml
  spring:
    rabbitmq:
      host: 192.168.1.100
      port: 5552
      username: your-username
      password: your-password
  

• 验证跨主机网络连通性
  在Spring Boot容器所在主机执行以下命令，确认网络和端口可达：

  # 测试主机连通性
  ping 192.168.1.100
  # 验证端口开放状态
  nc -zv 192.168.1.100 5552
  

  若ping不通，排查两台主机的防火墙、路由规则；若端口无法访问，确认RabbitMQ容器的端口映射是否正确（-p 5552:5552），以及主机防火墙是否放行5552端口。

• 调整Docker容器DNS配置（可选）
  如果使用主机名而非IP连接，确保Spring Boot容器的DNS能解析该主机名。可在启动容器时指定DNS服务器：

  docker run --dns 8.8.8.8 --name spring-boot-app your-spring-boot-image
  

  也可以检查Docker守护进程的默认DNS配置，确保其指向能正常解析外部主机名的服务器。

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