You need to enable JavaScript to run this app. Ubuntu EC2上Mosquitto Broker WebSocket连接异常排查修复
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.24 23:45:10