Сначала определите, что именно оборвалось: TCP/WebSocket, TLS, MQTT Keep Alive или сессия на broker. Запишите время последнего успешного packet, событие смены сети, момент disconnect callback, каждую попытку CONNECT и ответ CONNACK. Без этой шкалы одинаково выглядят потеря радио, истёкший token и отклонённый дубликат client ID.
Не вызывайте connect из нескольких listeners одновременно. Один reconnect controller принимает сигналы ОС и клиента, но держит только одну активную попытку. После ошибки он ждёт backoff с jitter; после успешного CONNACK сбрасывает задержку и восстанавливает состояние по результату сессии.
Один timeline различает четыре вида разрыва
| Наблюдение | Вероятный слой | Следующая проверка |
|---|---|---|
| Нет TCP connect | Сеть, DNS, порт | Route, captive portal, reachability |
| TLS завершается ошибкой | Сертификат, часы, SNI | Код TLS и цепочка сертификата |
| CONNACK с reason code | Auth, ACL, client ID, лимит broker | Точный reason без бесконечного retry |
| Соединение живёт до keep alive timeout | Потеря пакетов или зависший loop | PINGREQ/PINGRESP и работа event loop |
| Reconnect успешен, сообщений нет | Сессия/подписки не восстановлены | Session Present и SUBACK |
Не записывайте пароль и содержимое пользовательских сообщений. Полезны client ID в усечённом виде, версия протокола, transport, network type, reason codes, номера попыток и размеры очередей. Корреляция по monotonic time помогает отделить задержку сети от скачка системных часов.
Clean Start и Session Expiry задают продолжение
MQTT 5 разделяет начало новой сессии и срок хранения состояния после disconnect. Спецификация указывает: при Clean Start=0 и существующей сессии broker продолжает её; Session Expiry определяет, как долго состояние сохраняется. Clean Start=1 вместе с нулевым expiry эквивалентен одноразовой чистой сессии.
client_id = "sensor-demo-42"
clean_start = false
session_expiry_interval = 1800
keep_alive = 45
on CONNACK:
if session_present: continue queued flow
else: subscribe again and rebuild local assumptionsЧисла в примере условные. Expiry должен покрывать ожидаемый краткий обрыв, но не оставлять состояние навечно для исчезнувших устройств. Стабильный client ID обязателен для возобновления: случайный ID на каждый reconnect создаёт новую сессию. Одновременное использование одного ID двумя устройствами может, наоборот, выбивать соединения друг друга.
Backoff защищает broker и батарею
- Первая повторная попытка идёт после короткой задержки, а не в tight loop.
- Каждая неудача увеличивает интервал до разумного максимума.
- Jitter разносит устройства, которые потеряли сеть одновременно.
- Ошибки авторизации и запрещённый client ID не ретраятся бесконечно без изменения входных данных.
- Сигнал network available разрешает раннюю попытку, но не запускает второй controller.
Eclipse Paho реализует automatic reconnect с увеличением задержки между попытками; конкретные пределы зависят от клиента. Это удобная основа, но приложению всё равно нужно различать transient network failure и постоянный отказ конфигурации, а также показывать наблюдаемое состояние пользователю.
QoS не отменяет прикладную дедупликацию
QoS 1 означает доставку как минимум один раз, поэтому после разрыва возможен повтор. QoS 2 уменьшает риск дублей на уровне протокола, но дороже и не превращает две разные публикации приложения в одну. Добавьте message ID или sequence в payload и сделайте обработчик идемпотентным там, где повтор вреден.
После нового сеанса повторно подписывайтесь и проверяйте SUBACK, а не считайте вызов subscribe успехом. После продолженной сессии не создавайте параллельные обработчики. Решение определяется Session Present и подтверждениями broker, а не только фактом открытого socket.
Offline-очередь имеет предел и политику
Буфер без лимита съест память при часовом отсутствии сети. Для телеметрии часто можно агрегировать или заменить старое значение новым; для команд нужна строгая очередь, срок жизни и подтверждение. Paho JavaScript документирует disconnected publishing и максимальный размер буфера — настройка должна соответствовать семантике ваших сообщений.
При переполнении не молчите: увеличьте счётчик dropped/coalesced, сохраните причину и покажите состояние синхронизации. После reconnect отправляйте очередь с ограниченной скоростью, иначе восстановление само создаст новый обрыв.
Полевой тест меняет сеть в середине доставки
- Подключиться, подписаться и подтвердить контрольное сообщение.
- Начать QoS 1 публикацию и выключить сеть до подтверждения.
- Переключить Wi‑Fi на мобильную сеть и дождаться единственного reconnect controller.
- Проверить CONNACK Session Present, SUBACK при новой сессии и повтор сообщения.
- Оставить устройство offline дольше Session Expiry и повторить сценарий как новый сеанс.
Для диагностики нужны версия MQTT и библиотеки, broker, transport, схема Clean Start/Expiry, keep alive, client ID policy, reason codes и график попыток. Payload замените тестовым. Такой набор показывает, проблема в мобильном маршруте, session policy, авторизации или собственной очереди клиента.