Mosquitto桥接：如何同步清除远程已删除的本地保留消息？

问题原因 #

你的Mosquitto 1.6.10桥接能同步远程保留消息，但无法同步空Payload保留消息（用于清除保留消息），核心原因通常有两个：

• 未明确指定桥接使用的MQTT协议版本，导致与远程v3.1.1协议存在隐性兼容问题，空Payload的保留消息处理逻辑异常。
• 虽然默认桥接会转发保留消息，但显式配置缺失可能导致部分版本的Mosquitto对空Payload保留消息的处理被忽略。

解决方案 #

1. 明确指定桥接的MQTT协议版本 #

在桥接配置块中添加bridge_protocol_version mqttv311，强制桥接使用v3.1.1协议，确保和远程服务的协议完全对齐：

connection bridge-01
address url:1883
bridge_protocol_version mqttv311
try_private true
cleansession true
topic posttopic1 in 0 "" topic1
remote_username username
remote_password password

2. 显式启用保留消息转发 #

虽然bridge_retain默认值为true，但显式配置可以避免版本差异导致的默认行为变更，确保桥接处理所有保留消息（包括清除用的空Payload消息）：
在桥接配置中添加一行：

bridge_retain true

3. 验证本地Mosquitto的空消息允许配置 #

检查本地Mosquitto主配置文件（mosquitto.conf），确保存在allow_empty_messages true配置（默认启用，若被修改会导致空Payload消息被拒绝）。

4. 调整Topic映射配置（可选） #

如果上述配置仍未生效，可尝试简化Topic映射规则，确保远程与本地Topic的映射无歧义：

topic posttopic1 in 0 topic1 topic1

（此配置将远程posttopic1直接映射到本地topic1，无前缀干扰）

验证步骤 #

1. 重启本地Mosquitto服务，使新配置生效。
2. 在远程端发布空Payload+保留标志的消息到posttopic1。
3. 在本地订阅topic1，确认收到空Payload的保留消息，同时检查本地topic1的保留消息是否已被清除。

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