Повтор после reconnect не обязательно означает ошибку broker. MQTT QoS 1 допускает повторную доставку, а при восстановлении session клиент или сервер повторно отправляет неподтверждённые QoS-сообщения с прежним packet identifier. Retained команда может дополнительно прийти как первое сообщение новой подписки. Устройство обязано считать сеть источником повторов.

Packet Identifier и флаг DUP помогают диагностике, но не подходят как бизнес-идентификатор: identifier переиспользуется после завершения обмена, а приложение может создать новый PUBLISH для той же операции. Нужен command_id, который задаёт инициатор и сохраняет неизменным при каждом retry.

Команда несёт идентичность и срок годности

{
  "command_id": "01K6P7H7YJ5M8QW4T9R2",
  "device_id": "pump-042",
  "type": "dispense_ml",
  "arguments": {"amount": 50},
  "created_at": "2026-10-04T19:30:00Z",
  "expires_at": "2026-10-04T19:32:00Z"
}

state: received -> executing -> succeeded | failed
result is stored under command_id and returned for every duplicate

expires_at защищает от выполнения устаревшей операции после долгого offline-периода, но не заменяет дедупликацию. Сервер не должен генерировать новый ID при timeout, если это всё ещё та же операция: иначе устройство честно увидит две разные команды.

Состояние записывается раньше необратимого действия

  1. Проверить device_id, тип, подпись/authorization, срок и допустимость аргументов.
  2. Найти command_id в локальном durable journal.
  3. Если status succeeded или failed, вернуть сохранённый результат без повторного действия.
  4. Если ID новый, атомарно записать received или executing до физического side effect.
  5. Выполнить действие и сохранить итог с измеримым результатом.
  6. Опубликовать application result; сетевой ACK сам по себе не означает выполнение.

Самый трудный случай — питание пропало между действием и записью succeeded. Для него нужен предметный reconciliation: датчик положения клапана, номер чека, счётчик импульсов или запрос состояния исполнительного механизма. Только приложение знает, можно ли безопасно повторить шаг.

Симптом подсказывает источник повтора

Когда повторяетсяВероятная причинаЗащита
Сразу после reconnectПовтор unacknowledged QoS PUBLISHJournal по command_id
После новой subscriptionRetained one-shot commandНе retain одноразовые действия
После reboot устройстваДедупликация была только в RAMDurable journal
После timeout backendRetry получил новый command_idСохранять ID исходной операции
Два раза при QoS 1At-least-once deliveryИдемпотентный handler
После session expiryBackend переиздал pending commandReconcile status перед resend

Retained подходит для желаемого состояния — например setpoint=21 — когда повторное применение безопасно. Команда «выдать 50 мл» или «открыть дверь один раз» является событием и не должна жить в retained topic без ID, expiry и журнала исполнения.

ACK протокола и результат команды отвечают на разные вопросы

  • PUBACK сообщает о приёме QoS 1 сообщения следующим protocol peer.
  • Application result сообщает received, executing, succeeded или failed.
  • Backend повторяет запрос с тем же command_id и умеет запросить сохранённый status.
  • Устройство хранит journal дольше максимального окна retry и offline recovery.
  • Очистка journal учитывает срок команды и подтверждение, что backend получил итог.
  • Метрики отдельно считают delivery retries, duplicate commands и repeated side effects.

QoS 2 уменьшает дубликаты на protocol hop, но не закрывает падение приложения после физического действия и до durable commit. Поэтому повышение QoS без command journal даёт ложную уверенность и больше состояния в broker/client.

Тест reconnect должен быть разрушительным только для макета

На стенде отправьте одну команду, оборвите сеть до ACK, восстановите соединение и затем перезапустите устройство. В логах могут быть несколько доставок, но физический счётчик увеличивается один раз, а все ответы содержат один command_id и одинаковый финальный результат. Повторите с истёкшей командой и retained сообщением.

Для production-инцидента временно остановите опасный consumer или переведите actuator в безопасный режим. Соберите обезличенный MQTT trace, session settings, command journal и hardware evidence. Не очищайте очередь и retained topics до фиксации причины: это удалит главный след и может отправить команду заново при следующей подписке.

Проверенные источники