Docker Compose环境下NodeJS mqtt.js客户端无法经Nginx连Mosca Broker

看起来你遇到的核心问题是容器间的网络连通性和配置遗漏，我来一步步帮你排查解决：

1. 最关键的问题：NodeJS容器无法解析nginx主机名 #

在你的docker-compose.yml里，app1和app2的links配置中没有包含nginx服务，这意味着NodeJS容器内部无法通过nginx这个域名找到Nginx容器——这是导致连接失败的首要原因。

修复方法： #

修改app1和app2的配置，添加nginx的链接（或者利用Docker Compose默认网络的容器名解析特性）：

app1:
  build: ./node_app
  links:
    - mongo:mongo
    - mqttbroker1:mqttbroker1
    - mqttbroker2:mqttbroker2
    - nginx:nginx  # 新增这一行
  ports:
    - "3000"
  environment:
    - NODE_ENV=production
    - PORT=3000

app2:
  build: ./node_app
  links:
    - mongo:mongo
    - mqttbroker1:mqttbroker1
    - mqttbroker2:mqttbroker2
    - nginx:nginx  # 新增这一行
  ports:
    - "3000"
  environment:
    - NODE_ENV=production
    - PORT=3000

如果使用的是较新版本的Docker Compose，其实links可以不用显式配置（默认网络下容器名可直接访问），但显式添加能确保兼容性。

2. 验证Nginx Stream模块是否正常启用 #

Nginx的Stream模块是处理TCP/UDP流量（比如MQTT）的核心，需要确认你的Nginx镜像已经包含该模块：

• 进入Nginx容器：docker exec -it <nginx-container-name> /bin/bash
• 执行nginx -V，查看输出中是否有--with-stream字样。如果没有，说明你的Nginx没有编译Stream模块，需要修改Dockerfile：
  比如直接使用官方Nginx镜像（默认包含Stream模块），或者自定义编译时加上--with-stream参数。

3. 检查Nginx Stream配置的合法性 #

确保你的Nginx配置没有语法错误：
在Nginx容器内执行nginx -t，如果输出显示test is successful，说明配置没问题；如果报错，根据提示修正配置（比如端口、上游服务器地址的拼写错误）。

4. 调试NodeJS客户端的连接错误 #

给你的MQTT客户端添加错误监听，获取具体的失败原因，方便定位问题：

const mqttClient = mqtt.connect('mqtt://nginx:18833', { clientId: clientId });

// 添加错误监听
mqttClient.on('error', (err) => {
  console.error('MQTT连接错误:', err.message);
  console.error('错误代码:', err.code);
});

mqttClient.on('connect', () => {
  console.log('成功通过Nginx连接到MQTT Broker');
});

常见错误对应的问题：

• ENOTFOUND：主机名解析失败 → 对应问题1
• ETIMEDOUT：连接超时 → 检查Nginx是否能连通Broker，或者Stream配置是否正确
• ECONNREFUSED：连接被拒绝 → 检查Nginx的18833端口是否在监听，或者上游Broker是否正常运行

5. 验证容器间的连通性 #

• 在NodeJS容器内测试能否访问Nginx的18833端口：telnet nginx 18833，如果能连通，说明网络没问题；如果不能，检查Docker网络配置。
• 在Nginx容器内测试能否访问Broker的18831端口：telnet mqttbroker1 18831，确保Nginx能正常转发流量到Broker。

按照以上步骤排查，应该能解决你的问题。

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