1. Mosquitto配置中导致离线缓存失效的原因 #

你的配置里有几个关键设置直接影响了离线缓存功能，核心问题如下：

• cleansession true：这个参数是罪魁祸首。当它设为true时，桥接客户端（连接AWS IoT的Mosquitto桥实例）断开后，AWS IoT会清除该客户端的所有会话状态，包括未确认的QoS 1/2消息；同时Mosquitto本地也不会保留桥接的离线消息。要启用离线缓存，必须把它改成cleansession false，这样会话会被持久化，离线期间的消息会被存储，网络恢复后自动重发。

另外还有两个配置细节需要修正：

• 重复的SSL/TLS配置：你的配置里同时写了普通的cafile/keyfile/certfile和桥接专用的bridge_cafile/bridge_keyfile/bridge_certfile，这会导致配置冲突。桥接的SSL参数应该统一使用带bridge_前缀的项，删除前面的普通SSL配置，避免混淆。
• 持久化路径权限：虽然你开启了persistence true和persistence_location /var/lib/mosquitto/，要确保Mosquitto进程对该目录有读写权限，否则无法写入持久化文件，离线消息也存不住。

修正后的关键配置片段参考：

cleansession false
# 保留桥接专用SSL配置，删除重复的普通SSL项
bridge_cafile /home/pi/rootCA.cer
bridge_certfile /home/pi/bridge.cert.pem
bridge_keyfile /home/pi/bridge.private.key

2. 支持离线缓存的NodeJS MQTT库推荐 #

如果自行开发NodeJS桥接程序，以下几个库都原生支持离线消息缓存，按实用程度排序：

• MQTT.js：NodeJS生态里最主流的MQTT客户端库，支持MQTT 3.1/3.1.1/5.0全协议。启用离线缓存只需在连接时设置clean: false，它会自动缓存QoS 1/2的消息，网络恢复后自动重发；如果需要缓存QoS 0的消息，可以额外开启queueQoSZero: true选项。示例代码片段：

  const mqtt = require('mqtt')
  const fs = require('fs')
  
  const client = mqtt.connect('mqtts://aws.iot.us-west-2.amazonaws.com:8883', {
    clean: false, // 开启持久化会话，必备
    queueQoSZero: true, // 可选：缓存QoS 0消息
    ca: fs.readFileSync('/home/pi/rootCA.cer'),
    cert: fs.readFileSync('/home/pi/bridge.cert.pem'),
    key: fs.readFileSync('/home/pi/bridge.private.key')
  })
  

• async-mqtt：是MQTT.js的Promise封装版本，API更贴合现代异步编程习惯，完全继承了MQTT.js的离线缓存能力，用法和MQTT.js基本一致，只是用Promise替代了回调函数。

• Aedes：它本质是一个轻量级MQTT broker库，但也可以作为客户端使用，支持自定义持久化存储和离线消息管理，适合需要同时实现本地broker和桥接功能的复杂场景。

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