Обновление JSON Schema измерений без скрытого разрыва потребителей
Разработчик добавил диагностическое поле, считая изменение безопасным, но один старый потребитель начал отвергать сообщения. Другой продолжил работу, молча потеряв нужный статус. Совместимость формата зависит от правил схемы и поведения конкретных программ, поэтому её нельзя объявлять по одному факту успешного JSON разбора.
Зафиксировать исходную схему
JSON Schema позволяет задавать обязательность и правила дополнительных свойств. (JSON Schema — Understanding JSON Schema, Object) Запишите используемый диалект, настройки валидатора и фактический контракт производителей. Если разные сервисы применяют разные редакции схемы, составьте реестр, а не считайте один файл описанием всего работающего контура.
Сохраните библиотеку собственных сообщений прежней версии. В ней должны быть штатное измерение, отсутствие допустимого поля и диагностический случай. Проверка только идеального сообщения не показывает, что изменится для узлов, которые большую часть времени передают укороченный либо частичный набор.
Описать изменение по смыслу
Разделяйте добавление необязательного поля, изменение типа, новое обязательное свойство и изменение единицы. Все они могут выглядеть как небольшая правка текста схемы, но иметь разные последствия. Дополнительное поле с новым смыслом не должно незаметно заменять прежнее под тем же именем.
Определите, как потребитель узнаёт версию и что делает с неизвестной. Не выбирайте схему только по наличию одного случайного поля, если формат допускает его отсутствие. Версия должна иметь документированный источник и сохраняться вместе с данными для последующего разбора.
Проверить матрицу программ
На стенде сопоставьте старого и нового производителя со старым и новым потребителем. Для каждого сочетания запишите ожидаемый результат: принятие, ограниченная обработка или понятный отказ. Совместимость в одном направлении не доказывает возможность произвольного отката всей системы.
Увеличить схему
Проверьте не только валидацию, но и значения после обработки. Программа может успешно принять неизвестные поля и всё равно неправильно интерпретировать изменённые единицы. Если библиотека удаляет лишние свойства, убедитесь, что это не уничтожает диагностическую информацию, нужную другому участнику маршрута.
Запланировать смешанный период
Обновление удалённого парка обычно выполняется частями. Укажите допустимые сочетания версий и порядок переключения. Архив старых сообщений должен оставаться читаемым предусмотренным способом; выбор только последней схемы для всех лет истории может изменить смысл уже сохранённых записей.
Приёмка завершается матрицей результатов и проверенным смешанным потоком. После внедрения наблюдайте неизвестные версии и ошибки отдельно от физических отказов датчиков. Тогда развитие формата станет управляемым изменением контракта хозяйства, а не случайной проверкой того, какие старые программы ещё продолжают принимать новые сообщения.
