/
Common Mistakes with MQTT Topics

Common Mistakes with MQTT Topics

Understanding MQTT topic naming rules is essential for reliable message delivery. Here are the most common mistakes developers make:

Question: Are Sensor/Data and sensor/data the same topic?

No. MQTT topic names are case-sensitive.
Sensor/Data ≠ sensor/data
Make sure to use consistent casing across all publishers and subscribers.

Question: Are sensor/data and /sensor/data the same?

No. These are different topics.

  • sensor/data has two levels: sensor → data

  • /sensor/data has three levels: "" → sensor → data (note the empty root level)

Leading slashes matter in MQTT topics.

Question: Is "sensor/data " the same as "sensor/data" or " sensor/data"?

No. Any leading or trailing whitespace makes the topic a different string.
These are all distinct:

  • " sensor/data"

  • "sensor/data"

  • "sensor/data "

Be careful when copying/pasting or generating topic strings programmatically.