MQTT 协议桥接与主题路由

MQTT 桥接（Bridge）使两个或多个 Broker 之间能够跨网络转发消息，实现 IoT 系统的地理分布、负载分担与异构网络集成。主题路由决定消息在 Broker 间如何流动，主题命名规范、QoS 等级和数据保留策略直接影响桥接的可靠性与延迟。本章从原理到调优，完整覆盖桥接配置与路由治理。

1. Broker 桥接原理

桥接通过 remote_connection 配置使 Broker 成为另一个 Broker 的客户端。每一条桥接主题规则都可独立设置方向（out / in / both）、主题过滤器、QoS 等级以及是否转发保留消息。

• out 方向：本地消息推送到远程 Broker；
• in 方向：订阅远程 Broker 的主题，拉取消息到本地；
• both 方向：双向同步，适用于双活桥接。

2. Broker 安装与配置（Mosquitto）

1. 安装 Mosquitto（以 Ubuntu/Debian 为例）：

   sudo apt update
   sudo apt install mosquitto mosquitto-clients libmosquitto-dev

2. 新建桥接配置文件 /etc/mosquitto/conf.d/bridge.conf：

   # 桥接连接参数
   connection bridge-to-beijing
   address 192.168.10.20:1883
   remote_username bridge_user
   remote_password SecurePass123
   start_type automatic
   try_private false
   
   # 主题路由规则
   topic sensor/+/status out 1 0
   topic actuator/cmd/+/set in 2 1
   topic sys/# both 0 0

3. 重启 Mosquitto：

   sudo systemctl restart mosquitto

4. 验证桥接状态：

   mosquitto_sub -h localhost -t '$SYS/broker/connection/bridge-to-beijing/state'
   # 输出 1 表示已连接，0 表示断开

3. 主题命名规范

4. QoS 等级选择

桥接场景下 QoS 直接影响端到端交付保证与网络开销。下表对比三种等级在桥接中的表现：

5. 数据保留策略

保留消息（Retain）使 Broker 为每个主题持久保留下一条消息，新订阅的客户端立即收到。桥接时须决定是否转发保留消息：

• retain=0：丢弃保留标志，仅转发普通消息。适用于实时数据流（如传感器值），避免新客户端收到过时数据。
• retain=1：保留标志原样转发。适用于配置、状态、版本号等静态信息，保证远程端也能获得最新保留值。
• retain expiration：Mosquitto 1.6+ 支持 set_retain_available 1 并通过 mqtt5 retain-available 限制保留时间。

# 设置保留消息过期时间（秒）
mosquitto_pub -t "config/version" -m "v2.1.0" -r
# 远程桥接若配置 retain=1，则北京端新订阅者立刻收到该保留消息

6. 调试方法

• 本地监听桥接主题：

  mosquitto_sub -h localhost -t 'bridge/#' -v

• 远程端验证：在远程 Broker 上订阅被桥接的主题，确认消息流动。
• 使用 tcpdump 抓包：

  sudo tcpdump -i any port 1883 -X

• 查看 $SYS 主题：$SYS/broker/connection/<connection_name>/state 实时反映桥接状态。

7. 常见错误排查

8. 性能与稳定性优化

• 限制桥接主题数量：尽量避免 topic # both 全量同步，按业务域拆分多个 connection。
• 调整通知线程数：Mosquitto 1.6+ 支持 bridge_protocol_version mqttv311 和 bridge_insecure false 保证 TLS。
• 设置背压与重连间隔：

  # 桥接重连间隔（秒），默认 5，可调为 1~60
  bridge_attempt_unsubscribe false
  notifications true
  notification_topic "bridge/status/+"

• 使用 QoS 1 作为默认桥接等级，仅对关键路径升级到 QoS 2。
• 启用 MQTT 5.0 保留消息过期（Broker 兼容时）：减少陈旧保留数据对桥接带宽的浪费。