.NET Core控制台应用Docker部署连接RabbitMQ失败：Connection refused

从你的错误信息和配置来看，核心问题是你的.NET Core应用没有正确读取到Docker Compose中配置的RabbitMQ主机地址，导致它尝试连接默认的127.0.0.1（容器自身的localhost），而不是Docker网络中的rabbit服务节点。结合你的代码和配置，我整理了几个关键的修复步骤：

1. 修复环境变量的读取与命名 #

你的代码中使用Environment.GetEnvironmentVariable("RabbitMq/Host")来读取配置，但Docker环境中环境变量的分层命名（带斜杠）可能无法被正确识别。.NET Core推荐使用**双下划线__**来替代分层路径中的斜杠或冒号，这样配置系统能正确解析。

修改docker-compose.yml中的环境变量： #

# message.api和rsscomparator服务都需要调整
message.api:
  ...
  environment:
    - "RabbitMq__Host=rabbit"  # 用__替代原有的/
    - "RabbitMq__Username=guest"
    - "RabbitMq__Password=guest"

或者改用大写环境变量键（更适配Linux容器习惯）： #

如果你不想修改命名格式，也可以调整代码的读取逻辑，使用全大写的键名（Docker会自动将环境变量名转为大写）：

var factory = new ConnectionFactory() { 
    HostName = Environment.GetEnvironmentVariable("RABBITMQ_HOST"), 
    UserName = Environment.GetEnvironmentVariable("RABBITMQ_USERNAME"), 
    Password = Environment.GetEnvironmentVariable("RABBITMQ_PASSWORD") 
}; 

对应的docker-compose.yml修改为：

environment:
  - "RABBITMQ_HOST=rabbit"
  - "RABBITMQ_USERNAME=guest"
  - "RABBITMQ_PASSWORD=guest"

2. 添加RabbitMQ健康检查，确保服务就绪 #

depends_on仅保证容器的启动顺序，但不确保RabbitMQ服务已经完全初始化并可接受连接。当应用启动时，RabbitMQ可能还在加载，导致连接被拒绝。

给rabbit服务添加健康检查： #

rabbit:
  image: rabbitmq:3.7.2-management
  hostname: rabbit
  ports:
    - "15672:15672"
    - "5672:5672"
  healthcheck:
    test: ["CMD", "rabbitmq-diagnostics", "-q", "ping"]
    interval: 10s  # 每10秒检查一次服务状态
    timeout: 5s
    retries: 5

让应用服务等待RabbitMQ就绪后再启动： #

修改应用服务的depends_on配置，依赖RabbitMQ的健康状态：

message.api:
  ...
  depends_on:
    rabbit:
      condition: service_healthy  # 等待rabbit服务标记为健康后再启动

3. 验证环境变量是否正确读取 #

在代码中添加日志输出，确认环境变量是否被正确获取，避免因配置缺失导致的默认连接：

var rabbitHost = Environment.GetEnvironmentVariable("RabbitMq__Host");
Console.WriteLine($"当前读取的RabbitMQ主机地址: {rabbitHost ?? "未找到配置"}");

var factory = new ConnectionFactory() { 
    HostName = rabbitHost ?? throw new InvalidOperationException("未配置RabbitMQ主机地址"),
    UserName = Environment.GetEnvironmentVariable("RabbitMq__Username"), 
    Password = Environment.GetEnvironmentVariable("RabbitMq__Password") 
}; 

这样如果配置未读取到，会直接抛出明确的异常，方便快速排查问题。

按照以上步骤调整后，你的应用应该能正确连接到Docker网络中的RabbitMQ服务了。

内容的提问来源于stack exchange，提问作者t. YILMAZ