Docker中运行RabbitMQ收发服务报BrokerUnreachableException如何解决

核心问题说明 #

你遇到的RabbitMQ.Client.Exceptions.BrokerUnreachableException: None of the specified endpoints were reachable报错，本质是Docker内部署的Sender、Receiver服务无法访问到同环境的RabbitMQ服务，绝大多数情况是网络配置和连接地址设置错误导致，常见错误点如下：

• 连接地址配置为localhost/127.0.0.1：本地运行时RabbitMQ部署在本机所以访问正常，但容器内的localhost指向容器自身，无法关联到RabbitMQ服务容器
• 三个服务未加入同一个Docker网络：Docker默认网桥之间网络隔离，如果RabbitMQ、Sender、Receiver分别在不同网络下，自然无法互通
• 端口配置混淆：RabbitMQ服务通信端口为5672，管理后台端口为15672，服务连接时错用15672端口也会触发连接失败
• 权限配置错误：RabbitMQ未创建对应账户、未给账户分配指定vhost的访问权限，也会触发该报错

具体调整步骤 #

1. 统一容器网络配置
   创建自定义Docker网桥，将三个服务都加入同一网络：

# 创建专属网桥
docker network create rabbitmq-network
# 启动RabbitMQ时加入该网络，指定容器名为rabbitmq-server（该名称就是后续服务的连接地址）
docker run -d \
  --name rabbitmq-server \
  --network rabbitmq-network \
  -p 15672:15672 \
  -p 5672:5672 \
  rabbitmq:3-management
# 启动Sender、Receiver容器时，都指定加入rabbitmq-network网络

2. 修改RabbitMQ连接配置
   将原配置中的RabbitMQ连接地址从localhost/127.0.0.1修改为RabbitMQ的容器名rabbitmq-server，端口保持5672不变，同步确认账户密码、vhost参数和RabbitMQ内的配置一致即可。
3. 临时调试方案
   如果是本地调试不想调整容器网络，也可以将连接地址修改为宿主机的局域网IP，前提是RabbitMQ的5672端口已经映射到宿主机，生产环境推荐优先使用同网桥+容器名访问的方案。

内容的提问来源于stack exchange，提问作者Anthony Earl R. Cuartero