Ubuntu EC2上Mosquitto Broker WebSocket连接异常排查修复
Mosquitto WebSocket连接断连问题修复
核心问题定位
你遇到的断连问题本质上不是WebSocket服务本身不通,是两个明确的配置和逻辑错误叠加导致的:
- 连接链路错配:你写的测试脚本用
mqtt://前缀直连服务器默认1883端口,走的是原生TCP MQTT协议链路,根本没有访问9001端口的WebSocket服务,之前看到的连接日志全是1883端口的连接记录,和WebSocket链路无关 - 脚本逻辑bug:你的定时任务判断块漏了JS大括号,导致每次执行publish函数都会直接触发
client.end(),连接刚建立就被客户端主动关闭,刚好对应Mosquitto日志里「刚收到新客户端连接就立刻报Socket错误断开」的现象
具体修复步骤
1. 修正客户端连接的协议与端口配置
如果是从Vue Web页面发起连接,浏览器环境不允许直接发原生TCP MQTT请求,必须走WebSocket通道,连接配置要改成:
- 连接协议前缀从
mqtt://换成ws://(如果后续上TLS就换成wss://) - 连接地址明确带上9001的WebSocket监听端口
正确的初始化代码示例:
import mqtt from 'mqtt' // 替换成你自己的EC2公网IP const client = mqtt.connect("ws://你的EC2公网IP:9001", { clientId: "mqttjs01", keepalive: 60 })
你本地跑的Node.js测试脚本也要同步把连接地址从mqtt://xx.xxx.xxx.xxx改成ws://xx.xxx.xxx.xxx:9001,否则永远不会触发WebSocket链路的连接。
2. 修复脚本的逻辑语法错误
你原脚本里publish函数的这段代码有明确的块级作用域错误:
count+=1; if (count==2) //ens script clearTimeout(timer_id); //stop timer client.end();
因为JS语法里没有大括号包裹的话,if判断只会控制紧跟的第一行代码,后面的client.end()是每次publish调用都会执行的逻辑——连接刚建立,第一次5秒定时任务触发的时候,就会直接把客户端连接断开,Mosquitto端检测到Socket被对端关闭,就会打印对应的Socket error日志。
修正后的正确代码:
count+=1; // 补齐大括号,把所有需要在count等于2时执行的代码包进判断块 if (count==2) { clearTimeout(timer_id); //stop timer client.end(); }
3. 排查容易遗漏的配置项
代码改完之后,还要核对两个基础检查点,避免剩下的隐性问题:
- 检查EC2安全组的入方向规则,确认9001端口对客户端所在的公网IP开放,否则连接请求到不了Mosquitto服务
- 确认Mosquitto的配置没有语法错位:你当前的
listener 9001、protocol websockets、allow_anonymous true配置完全符合1.6.7版本的语法要求,不需要额外加其他配置(只有需要用Mosquitto托管静态网页的时候才需要配置http_dir参数) - 1.6.7版本的Mosquitto不会对WebSocket连接的路径做强制校验,不需要在连接地址后面硬加
/mqtt路径,只要是发到9001端口的符合MQTT-over-WebSocket规范的请求都能正常处理
内容的提问来源于stack exchange,提问作者nidadinch
相关产品推荐
相关产品推荐

