Início / Guias técnicos / MQTT QoS e retained no ESP32: quando utilizar cada recurso
MQTT e segurança · Guia técnico

MQTT QoS e retained no ESP32: quando utilizar cada recurso

Entenda entrega MQTT, duplicações e mensagens retidas antes de decidir como representar atuadores.

MQTT QoS retained ESP32

O problema e por que importa

QoS 0 favorece telemetria frequente que tolera perda; QoS 1 pode repetir mensagens e exige consumidores idempotentes. Mensagens retained armazenam o último payload por tópico, mas não substituem o estado atual do dispositivo.

Como estruturar a implementação

Trate IDs de comando ou sequência de operação para impedir execução duplicada. Use retained preferencialmente em estados reportados e configurações que façam sentido ao reconectar; ordens de ligar ou abrir exigem análise especial.

Testes que ajudam a validar a solução

Derrube a conexão no meio de uma publicação, repita o mesmo comando e observe se um atuador recebe acionamento duplicado. Confirme que um cliente recém-conectado diferencia informação de ordem.

Cuidados, limitações e erros comuns

Uma ordem retained enviada antes da perda de rede pode ser executada muito depois, em contexto inseguro. Não confie apenas no QoS para definir confirmação física ou autorização.

Checklist de revisão

  • Distinguir semântica de cada tópico
  • Testar duplicidade em QoS 1
  • Evitar comandos retained inseguros

Onde continuar estudando

Este guia é um material técnico educativo, não uma especificação contratual de recursos disponíveis na plataforma. Para fluxos e exemplos da TechRib, consulte a documentação pública. Para conhecer o produto, explore a demonstração e os planos.

Leituras relacionadas

Ver todos os guias técnicos