MQTT主题通配符+和#的5个实战技巧（附EMQX配置示例）

MQTT主题通配符+和#的5个实战技巧（附EMQX配置示例）

最近在调试一个智能家居项目时，我遇到了一个挺有意思的问题。几个房间的温湿度传感器数据，按理说应该能通过一个订阅就全部收到，但实际运行时，总有一两个设备的数据“失踪”。排查了半天，最后发现是主题通配符用错了。+和#这两个看似简单的符号，用好了是提升开发效率的神器，用不好就是埋下各种“坑”的隐患。很多刚接触MQTT的开发者，包括我自己早期，都容易把它们的基础规则和实际应用场景混淆。这篇文章，我就结合自己踩过的坑和项目中的实战经验，聊聊如何真正用好这两个通配符，并分享一些在EMQX服务器上的具体配置思路，希望能帮你避开那些常见的误区。

1. 从“是什么”到“怎么用”：重新理解通配符的边界

很多教程会告诉你，+是单层通配符，#是多层通配符。这个定义没错，但它太抽象了，在实际编码时，你脑子里需要的是一个更具体的“地图”。我的理解是，可以把MQTT主题想象成一个文件系统路径，/就是目录分隔符。

+代表的是一个确定的、但内容未知的目录名。比如home/floor1/+/temperature，这里的+必须对应floor1下面的一个具体房间名，比如room101或livingroom。它不能是空，也不能跨越多个目录。这就意味着，home/floor1/temperature（缺少房间层）和home/floor1/room101/bedside/temperature（房间层下还有子层）都无法被这个订阅匹配到。理解这一点，是避免订阅失效的关键。

而#则代表从这个位置开始，后面的所有路径（包括零层或多层）。它更像是一个递归搜索的指令。订阅home/floor1/#，可以匹配到：

• home/floor1 （零个子层）
• home/floor1/temperature （一个子层）
• home/floor1/room101/temperature （两个子层）
• home/floor1/room101/bedside/temperature （三个子层）

这里有一个极其重要的规则：#必须是主题的最后一个字符，并且占据整个层级。home/#/sensor这种写法是无效的，因为#后面还有内容；home/floor#也是无效的，因为#没有独立占据一个层级。

注意：通配符只能用于订阅，不能用于发布。你不能向 sensor/+/data 这样的主题发布消息，因为 Broker 不知道 + 具体指代什么。

为了更直观地区分，我们可以看下面这个对比表格：