Node.js无法连接Docker容器中的RabbitMQ问题求助

先排查基础运行状态 #

• 确认RabbitMQ容器正常启动：执行docker ps，查看容器状态是否为Up；如果未启动，执行docker-compose up -d重新启动。
• 验证端口映射有效性：访问http://localhost:15672，用默认账号guest/密码guest登录管理界面，能正常进入说明容器服务本身无问题。同时在Windows终端执行netstat -ano | findstr :5672，确认5672端口被Docker进程占用。

修复代码中的异步时序问题 #

你的publishMessage方法中调用createChannel()时没有加await，导致后续操作尝试使用未初始化的channel，这是常见的隐性错误：

async publishMessage(routingKey, message) {
  if (!this.channel) {
    // 必须加await，确保channel创建完成后再执行后续操作
    await this.createChannel();
  }
  const exchangeName = "logExchange";
  await this.channel.assertExchange(exchangeName, "direct");

  const logDetail = {
    logType: routingKey,
    message: message,
    dateTime: new Date(),
  };
  await this.channel.publish(
    exchangeName,
    routingKey,
    Buffer.from(JSON.stringify({logDetail}))
  );

  console.log(`The message ${message} is sent to exchange`);
}

同时给createChannel添加错误捕获，明确连接失败的具体原因：

async createChannel() {
  try {
    const connection = await amqp.connect('amqp://guest:guest@localhost:5672');
    this.channel = await connection.createChannel();
    console.log('RabbitMQ 连接成功');
  } catch (err) {
    console.error('RabbitMQ 连接失败:', err.message);
    throw err; // 抛出错误让上层处理
  }
}

解决Windows+WSL2 Docker的网络映射问题 #

如果你的Docker使用WSL2后端，偶尔会出现localhost无法正确映射到容器的情况：

1. 打开WSL终端（比如Ubuntu），执行hostname -I获取WSL2的IP地址。
2. 将连接字符串替换为amqp://guest:guest@[WSL_IP]:5672，其中[WSL_IP]替换为你拿到的IP。

补充Docker容器配置（可选） #

如果是权限或节点名称导致的连接问题，修改docker-compose.yml添加环境变量：

version: '3'
services:
  rabbitmq:
    image: rabbitmq:3-management
    hostname: rabbitmq
    ports:
      - 5672:5672
      - 15672:15672
    environment:
      - RABBITMQ_DEFAULT_USER=guest
      - RABBITMQ_DEFAULT_PASS=guest
      - RABBITMQ_NODENAME=rabbit@localhost
    # expose可以去掉，ports已完成端口映射，expose仅用于容器间通信

日志排查技巧 #

• 查看RabbitMQ容器完整日志：执行docker logs [你的rabbitmq容器ID]，检查是否有启动异常、端口绑定失败等信息。
• 运行Express应用时，确保控制台能看到错误输出，根据具体错误信息（比如ECONNREFUSED、认证失败等）精准定位问题。

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