Повтор после 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 duplicateexpires_at защищает от выполнения устаревшей операции после долгого offline-периода, но не заменяет дедупликацию. Сервер не должен генерировать новый ID при timeout, если это всё ещё та же операция: иначе устройство честно увидит две разные команды.
Состояние записывается раньше необратимого действия
- Проверить device_id, тип, подпись/authorization, срок и допустимость аргументов.
- Найти command_id в локальном durable journal.
- Если status succeeded или failed, вернуть сохранённый результат без повторного действия.
- Если ID новый, атомарно записать received или executing до физического side effect.
- Выполнить действие и сохранить итог с измеримым результатом.
- Опубликовать application result; сетевой ACK сам по себе не означает выполнение.
Самый трудный случай — питание пропало между действием и записью succeeded. Для него нужен предметный reconciliation: датчик положения клапана, номер чека, счётчик импульсов или запрос состояния исполнительного механизма. Только приложение знает, можно ли безопасно повторить шаг.
Симптом подсказывает источник повтора
| Когда повторяется | Вероятная причина | Защита |
|---|---|---|
| Сразу после reconnect | Повтор unacknowledged QoS PUBLISH | Journal по command_id |
| После новой subscription | Retained one-shot command | Не retain одноразовые действия |
| После reboot устройства | Дедупликация была только в RAM | Durable journal |
| После timeout backend | Retry получил новый command_id | Сохранять ID исходной операции |
| Два раза при QoS 1 | At-least-once delivery | Идемпотентный handler |
| После session expiry | Backend переиздал pending command | Reconcile 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 до фиксации причины: это удалит главный след и может отправить команду заново при следующей подписке.