Docker Compose中Publisher服务无法连接RabbitMQ的排查与解决

可能原因及对应解决步骤 #

1. RabbitMQ未完成初始化就发起连接 #

Docker Compose默认仅等待容器启动，不会等待内部服务就绪。即使RabbitMQ容器显示运行中，其AMQP服务可能还在初始化（比如首次启动时创建数据库、加载插件），此时Publisher的连接请求会失败。

解决方法：
在docker-compose.yaml中为RabbitMQ添加健康检查，并让Publisher依赖RabbitMQ的健康状态：

rabbitmq:
  image: rabbitmq:3-management
  ports:
    - "5672:5672"
    - "15672:15672"
  healthcheck:
    test: ["CMD", "rabbitmq-diagnostics", "check_port_connectivity"]
    interval: 10s
    timeout: 5s
    retries: 5

publisher:
  build: ./Publisher
  depends_on:
    rabbitmq:
      condition: service_healthy

2. 连接字符串配置错误 #

最常见的问题是使用localhost而非Docker Compose服务名rabbitmq作为主机地址——容器内的localhost指向自身，而非RabbitMQ容器。另外需确认端口、凭证是否正确。

解决方法：
检查Publisher的配置文件（如appsettings.json）或代码中的连接字符串，确保格式正确：

{
  "RabbitMQ": {
    "ConnectionString": "amqp://guest:guest@rabbitmq:5672/"
  }
}

在代码中确认连接工厂的配置，同时延长超时时间适配初始化耗时：

var factory = new ConnectionFactory
{
    Uri = new Uri(Configuration["RabbitMQ:ConnectionString"]),
    RequestedConnectionTimeout = TimeSpan.FromSeconds(30)
};

3. RabbitMQ内部监听端口异常 #

RabbitMQ可能未正确监听5672端口，导致无法接收连接。

排查步骤：
进入RabbitMQ容器执行命令，检查监听状态：

docker exec -it <rabbitmq容器ID> rabbitmq-diagnostics listeners

确认输出中包含类似Listener on [::]:5672的条目。如果没有，检查是否修改了RabbitMQ的默认端口配置，或环境变量RABBITMQ_NODE_PORT被错误设置。

4. 端口连通性验证（补充排查） #

虽然已确认主机名可解析，仍需验证端口连通性：
进入Publisher容器执行端口测试：

docker exec -it <publisher容器ID> nc -zv rabbitmq 5672

如果测试失败，检查：

• RabbitMQ容器是否在docker-compose.yaml中开放了5672内部端口（无需映射到宿主机，但必须确保容器内端口可用）
• 所有服务是否在同一Docker网络中（执行docker network inspect <项目名>_default确认）

5. RabbitMQ用户权限问题 #

默认的guest用户允许同一Docker网络内的访问，但如果自定义了RabbitMQ用户，需确保该用户拥有访问虚拟主机/的权限。

排查步骤：
通过RabbitMQ管理界面（http://localhost:15672）登录，检查用户权限是否正确配置。

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