Docker Compose与RabbitMQ配置问题：微服务容器连接RabbitMQ失败

核心原因 #

Docker容器内的localhost指向容器自身的网络栈，而非宿主机。你的微服务容器硬编码连接rabbitmq://localhost/，但RabbitMQ运行在独立容器中，因此无法通过localhost访问到服务。而未容器化时，IISExpress直接运行在宿主机，localhost能正确指向宿主机上的RabbitMQ实例。

具体修复步骤 #

1. 调整docker-compose.yaml配置 #

给RabbitMQ服务指定明确的服务名（比如rabbitmq），让微服务通过该服务名访问RabbitMQ：

version: '3.8'
services:
  rabbitmq:
    image: rabbitmq:management
    ports:
      - "5672:5672"
      - "15672:15672"
    environment:
      RABBITMQ_DEFAULT_USER: guest
      RABBITMQ_DEFAULT_PASS: guest

  service-a:
    build: ./ServiceA
    depends_on:
      - rabbitmq
    environment:
      RABBITMQ_URI: rabbitmq://guest:guest@rabbitmq/

  service-b:
    build: ./ServiceB
    depends_on:
      - rabbitmq
    environment:
      RABBITMQ_URI: rabbitmq://guest:guest@rabbitmq/

2. 修改微服务的连接配置 #

在微服务代码中读取环境变量里的RabbitMQ地址，替换硬编码的localhost。以Mass Transit配置为例：

var rabbitMqUri = Environment.GetEnvironmentVariable("RABBITMQ_URI") ?? "rabbitmq://localhost/";

services.AddMassTransit(x =>
{
    // 配置消费者等逻辑

    x.UsingRabbitMq((context, cfg) =>
    {
        cfg.Host(new Uri(rabbitMqUri), h =>
        {
            h.Username("guest");
            h.Password("guest");
        });
        // 其他配置项
    });
});

3. 处理服务就绪等待问题 #

depends_on仅保证容器启动顺序，不确保RabbitMQ服务完全就绪。可添加健康检查，让微服务等RabbitMQ就绪后再启动：

rabbitmq:
  image: rabbitmq:management
  ports:
    - "5672:5672"
    - "15672:15672"
  environment:
    RABBITMQ_DEFAULT_USER: guest
    RABBITMQ_DEFAULT_PASS: guest
  healthcheck:
    test: ["CMD", "rabbitmq-diagnostics", "-q", "ping"]
    interval: 30s
    timeout: 10s
    retries: 3

service-a:
  build: ./ServiceA
  depends_on:
    rabbitmq:
      condition: service_healthy
  # 其他配置

调整完成后，微服务会通过Docker内部的服务发现机制，正确连接到RabbitMQ容器。

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