单片机与物联网 / 系统课时

编写服务端消息消费程序

编写服务端消息消费程序

设备消息进入 Broker 后,还需要后端订阅、解析并交给业务逻辑。这里用 Node.js 和 MQTT.js 实现一个常驻消费者:校验温度负载、隔离坏消息,在断线后恢复订阅,并在退出时关闭连接。

学习目标

  • 使用 MQTT.js 以 QoS 1 订阅设备遥测消息并校验 JSON。
  • 根据 Broker 会话状态恢复订阅,处理断线重连和进程退出。
  • 区分 MQTT 交付确认与业务处理成功,识别重复消费风险。

明确消息消费边界

设备向 factory/line1/device/t01/telemetry 发布数据,服务端订阅 factory/line1/device/+/telemetry,其中 + 匹配一个主题层级。服务端接到的负载是字节数据,必须先按 UTF-8 解码,再解析 JSON、校验字段,最后才允许进入业务逻辑。

设备消息消费及重连恢复的双通道关系

消费者使用固定 clientId、clean: false 建立 MQTT 3.1.1 持久会话。Broker 保有该会话时,离线期间符合条件的 QoS 1 消息可以排队;恢复连接后通过 sessionPresent 判断原订阅是否还在。示例不把解析失败误认为可以由 MQTT 自动重试解决。

启动 Broker 并准备依赖

准备 Node.js 20 或更新版本、Mosquitto Broker 及命令行工具 mosquitto_pub。在一个终端启动只用于本机实验的 Broker;如果已有服务占用 1883,应改用该服务而不是再启动一个。

bash
mosquitto -p 1883 -v

预期结果:Broker 在前台持续运行并监听本机 1883。Mosquitto 2.x 无自定义监听配置时通常只允许本机访问;具体启动日志随版本变化。

另开终端创建 Node.js 项目并安装 MQTT.js 5.x:

bash
mkdir mqtt-consumer
cd mqtt-consumer
npm init -y
npm install mqtt@^5

预期结果:出现 package.json、package-lock.json 和 node_modules,其中包含 mqtt 依赖。下面的连接地址与端口以本机实验为准;接入已启用认证或 TLS 的 Broker 时需相应调整连接配置。

编写可恢复的消费者

新建 consumer.js,保存以下完整代码。关闭 MQTT.js 自动重订阅,改由 sessionPresent 明确控制:无旧会话时订阅,有旧会话时沿用 Broker 保存的订阅。

js
const mqtt = require('mqtt');

const filter = 'factory/line1/device/+/telemetry';
const client = mqtt.connect('mqtt://127.0.0.1:1883', {
  clientId: 'backend-consumer-01',
  protocolVersion: 4,
  clean: false,
  reconnectPeriod: 2000,
  resubscribe: false
});

client.on('connect', (connack) => {
  console.log(`连接成功,sessionPresent=${connack.sessionPresent}`);
  if (connack.sessionPresent) {
    console.log('沿用已有订阅');
    return;
  }
  // Broker 没有保存会话时必须重新建立订阅
  client.subscribe(filter, { qos: 1 }, (err, granted) => {
    if (err || !granted?.length || granted[0].qos === 128) {
      console.error('订阅失败:', err?.message ?? 'Broker 拒绝');
      return;
    }
    console.log(`订阅成功 ${granted[0].topic} QoS=${granted[0].qos}`);
  });
});

client.on('message', (topic, bytes) => {
  try {
    const data = JSON.parse(bytes.toString('utf8'));
    if (!data || typeof data.temperature !== 'number' ||
        !Number.isFinite(data.temperature)) {
      throw new Error('temperature 必须是有限数字');
    }
    console.log(`温度 ${topic} = ${data.temperature} °C`);
    // 正式业务应在持久化层用事件 ID 做幂等校验
  } catch (err) {
    // 坏消息隔离记录,避免异常终止整个消费进程
    console.error(`无效消息 ${topic}: ${err.message}`);
  }
});

client.on('offline', () => console.log('客户端离线'));
client.on('reconnect', () => console.log('正在重连'));
client.on('error', (err) => console.error('MQTT 错误:', err.message));

const shutdown = () => client.end(false, () => process.exit(0));
process.once('SIGINT', shutdown);
process.once('SIGTERM', shutdown);

预期结果:程序具备连接、订阅、解码、异常隔离和退出回调;实际日志在运行及收到消息后产生。reconnectPeriod: 2000 表示断线后大约每两秒尝试重连,不能保证 Broker 拒绝认证时也会持续重试。

验证消息与离线恢复

在项目目录运行消费者,并让它保持运行:

bash
node consumer.js

首次建立新会话的预期输出:

text
连接成功,sessionPresent=false
订阅成功 factory/line1/device/+/telemetry QoS=1

如果 Broker 已保留相同 clientId 的会话,会看到 sessionPresent=true 和“沿用已有订阅”,这是正常分支。另开终端依次发布合法与非法负载:

bash
mosquitto_pub -h 127.0.0.1 -p 1883 -q 1 -t factory/line1/device/t01/telemetry -m '{"temperature":23.6,"status":"ok"}'
mosquitto_pub -h 127.0.0.1 -p 1883 -q 1 -t factory/line1/device/t01/telemetry -m '{"temperature":"bad"}'

预期结果:发布命令成功时通常不打印内容;消费者依次输出:

text
温度 factory/line1/device/t01/telemetry = 23.6 °C
无效消息 factory/line1/device/t01/telemetry: temperature 必须是有限数字

要验证离线消息,在消费者终端按 Ctrl+C,保持 Broker 运行,并再次发布一条合法 QoS 1 消息;然后重新执行 node consumer.js。如果 Broker 保留了会话和排队消息,预期出现 sessionPresent=true,并收到离线期间的消息。若重启 Broker 且未启用持久化,旧会话可能丢失,程序会重新订阅。

防止消费成功的假象

MQTT QoS 1 保证的是协议层至少一次交付,不保证数据已经写进数据库。MQTT.js 会处理协议确认;本例捕获解析错误只是在保护进程,不会把坏消息自动放进重试队列,也没有实现数据库写入失败的补偿。

实际接入订单、告警等业务时,让发布端附带稳定的 eventId 或设备序号,数据库以该标识建立唯一约束;先可靠落库再推进后续业务,对无法处理的消息保存失败记录。若修改了订阅主题集合,也要显式更新旧持久会话中的订阅,不能仅凭 sessionPresent=true 就认为配置已同步。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

编写服务端消息消费程序

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通