NestJS连接Docker部署的RabbitMQ出现ECONNREFUSED错误求助

错误现象 #

应用启动后抛出连接拒绝错误，日志显示尝试连接::1:5672和127.0.0.1:5672失败。

核心错误原因及修正方案 #

1. RabbitMQ连接端口配置错误 #

RabbitMQ的AMQP协议默认端口是5672，你在.env里配置的RABBITMQ_URL误用了15672（这是RabbitMQ管理后台的端口），导致应用通过错误端口发起连接。

修正：
修改.env中的RABBITMQ_URL为正确的AMQP端口：

RABBITMQ_URL=amqp://{rabbitmq容器名称或IP}:5672

2. 容器内localhost指向错误 #

Docker容器中，localhost指向容器自身而非宿主机或RabbitMQ容器。你的应用配置使用localhost，导致它试图连接自身内部的5672端口（应用容器内未部署RabbitMQ），因此连接被拒绝。

修正：

• 若RabbitMQ通过Docker Compose部署在同一个外部网络servers_default中，将RABBITMQ_URL里的localhost替换为RabbitMQ容器的名称（例如rabbitmq）。
• 若RabbitMQ部署在宿主机，在docker-compose.yml中添加宿主机映射：

  extra_hosts:
    - "host.docker.internal:host-gateway"
  

  同时修改RABBITMQ_URL：

  RABBITMQ_URL=amqp://host.docker.internal:5672
  

3. 未确认RabbitMQ服务状态及网络连通性 #

• 确认RabbitMQ服务已启动，且运行在servers_default外部网络中。
• 执行docker network inspect servers_default查看网络内的容器，验证RabbitMQ容器是否在列表中。
• 进入应用容器执行ping {rabbitmq容器名称}，测试网络连通性，排除网络隔离问题。

4. Dockerfile暴露端口与实际应用端口不一致 #

Dockerfile中EXPOSE 3000，但应用实际使用.env中的3001端口。虽不直接影响RabbitMQ连接，但会导致端口映射混乱，建议修正为：

EXPOSE ${PORT}

或固定端口：

EXPOSE 3001

总结 #

最关键的问题是端口配置错误和容器内localhost指向错误，修正这两点后，再确认RabbitMQ的网络状态，即可解决连接拒绝问题。

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