MQTT не сохраняет адрес брокера за устройство. Если после reboot возвращаются старые host, port или Client ID, исправлять нужно жизненный цикл локальной конфигурации: записать её в энергонезависимое хранилище, подтвердить завершение операции и на следующем старте загрузить именно сохранённую версию до запуска сетевого клиента.
Сначала зафиксируйте фактическое поведение: какой endpoint показан в интерфейсе, какой fingerprint конфигурации записан во flash и к какому IP устройство действительно открывает соединение после холодного старта. Это сразу разделяет ошибку сохранения, ошибку чтения и ситуацию, когда DNS уже ведёт то же имя на другой адрес.
Не смешивайте конфигурацию устройства и MQTT-сессию
| Данные | Где им жить | Что проверять |
|---|---|---|
| Broker hostname, port, transport | Persistent config устройства | Версия схемы, допустимый порт, длина строки |
| Client ID и имя профиля | Persistent config устройства | Уникальность и разрешённые символы |
| Подписки и QoS flow | MQTT session state клиента и брокера | Clean Start и Session Expiry |
| CA certificate или его fingerprint | Защищённый раздел/образ | Срок действия и соответствие endpoint |
| Private key устройства | Secure element или шифрованное хранилище | Недоступность из логов и обычного config API |
| Последняя ошибка соединения | Диагностический журнал | Не использовать как источник конфигурации |
Session Expiry в MQTT 5 определяет, как долго брокер и клиент сохраняют состояние MQTT-сессии после разрыва. Он не обязан помнить URL, пароль Wi-Fi или пользовательские настройки вашей прошивки. Поэтому увеличение Session Expiry не исправит исчезающий broker address.
Сохраняйте один версионированный снимок
config_record:
schema_version: 3
generation: 42
broker_host: mqtt.example.net
broker_port: 8883
tls_profile: production-ca-v2
client_id: sensor-017
payload_crc: <calculated>
write flow:
validate candidate
write inactive slot
commit and check result
read back and validate CRC
mark generation activeОтдельная запись каждого поля создаёт промежуточные комбинации: новый host может оказаться рядом со старым TLS profile. Удобнее хранить согласованный снимок с версией схемы и generation. Если платформа уже обеспечивает атомарную запись небольшого значения, используйте её контракт; если нет — два слота позволяют выбрать после reboot последнюю полностью валидную generation.
В ESP-IDF NVS предназначено для относительно небольшого и стабильного набора параметров вроде конфигурации, калибровки и флагов состояния. Оно работает с key-value значениями во flash и требует проверять возвраты операций, включая commit. Постоянно растущий журнал измерений лучше хранить другим механизмом: это отдельная задача с иным профилем записи.
Boot должен иметь однозначный порядок
- Инициализировать persistent storage и сохранить код ошибки, не запуская MQTT заранее.
- Прочитать обе копии записи или нужные keys, проверить типы, длины, schema version и checksum.
- Выбрать последнюю целую generation и выполнить миграцию старой схемы в памяти.
- Проверить hostname, port, transport и совместимость TLS profile как единый набор.
- Только после этого создать MQTT client и записать в журнал безопасный fingerprint активной версии.
- Если валидной записи нет, включить явный provisioning/recovery mode и сообщить причину локально.
Молчаливый fallback на production broker опасен: владелец считает, что устройство отключено, а оно продолжает отправлять данные по заводскому адресу. Заводские значения допустимы только как явно обозначенное состояние первичной настройки. Ошибка чтения flash, неизвестная schema version и неверный checksum должны различаться в диагностике.
Секреты требуют отдельного контура
CRC обнаруживает случайное повреждение, но не защищает от чтения или подмены. ESP-IDF прямо предупреждает, что без NVS encryption человек с физическим доступом к flash может читать и менять пары key-value. Закрытый ключ, пароль брокера и refresh token не стоит складывать рядом с обычным hostname в незашифрованном namespace.
- Не печатайте secret, private key и полный connection string в boot log.
- Храните ссылку на TLS profile отдельно от самого закрытого ключа.
- Проверяйте, что config export маскирует credential и не включает удалённые старые значения.
- При смене broker переоцените trust anchor и имя в сертификате, а не только TCP-доступность.
- Предусмотрите отзыв credential потерянного устройства независимо от перепрошивки.
Обрыв питания проверяют в момент записи
На стенде меняйте конфигурацию между двумя тестовыми broker и отключайте питание на разных стадиях: до commit, во время commit, после commit и при первом чтении. После каждого включения устройство должно выбрать либо полностью старую, либо полностью новую конфигурацию. Комбинация нового host со старым портом, пустая строка или самопроизвольный factory reset — провал теста.
| Сценарий | Ожидаемый результат | Что сохранить |
|---|---|---|
| Обычный reboot после сохранения | Новая generation активна | Fingerprint, generation, endpoint |
| Питание пропало до commit | Работает последняя подтверждённая запись | Код незавершённой операции |
| Повреждён новый слот | Выбран предыдущий валидный слот | Причина отбраковки и CRC |
| Неизвестная schema version | Recovery mode, без подключения | Версия прошивки и записи |
| Flash заполнена | Настройка отклонена до reboot | Ошибка записи без секрета |
Финальная проверка идёт по сети: DNS lookup, TLS handshake и CONNECT должны относиться к выбранному профилю. Для разбора подготовьте модель устройства, версию SDK, layout разделов, коды возврата storage API, fingerprint старой и новой конфигурации и последовательность питания. Сертификаты и пароли передавать не нужно.