Информатика · объяснение и практика

Почему повтор имени поля JSON опасен для обмена данными

Распознаём повторяющиеся имена полей JSON, объясняем различия декодеров и отклоняем неоднозначный документ до превращения его в обычный словарь.

Синие фигурные скобки держат между собой оранжевый квадрат.

В теме Электронные таблицы и форматы данных · Учебная карта

Главная мысль

RFC8259 рекомендует уникальные имена внутри JSON-объекта. При повторе разные получатели могут оставить последнее, первое, все значения или отклонить документ. Для надёжного API повторы лучше явно запрещать на этапе разбора.

Почему два поля не становятся списком автоматически

Представим объект с двумя вхождениями имени«limit»: сначала 10, затем 100. Автор мог ожидать, что оба ограничения сохранятся, но обычный словарь Python хранит только одно значение на ключ. Стандартный json-декодер Python по умолчанию оставляет последнее, то есть 100. Информация о первом после такого преобразования уже потеряна.

Массив значений нужно передавать массивом, если таков контракт. Повтор имени поля не является переносимым способом записать несколько элементов. При этом важно точно читать стандарт: требование уникальности сформулировано как рекомендация для совместимости, а не как простое правило, что любой парсер обязан выдать синтаксическую ошибку. Именно различия поведения создают проблему обмена.

Как возникает расхождение между проверкой и обработкой

Если проверяющий компонент видит первое limit = 10, а исполняющий оставляет последнее 100, они применяют разные ограничения к одному сообщению. Даже без злого умысла это даёт неожиданный результат. В полях прав доступа или размеров такая неоднозначность особенно нежелательна. Нельзя считать безопасным сообщение только потому, что одна библиотека его успешно разобрала.

Для Python можно использовать object_pairs_hook, получая пары до превращения объекта в словарь. На этом этапе проверяют повтор имени и отклоняют документ согласно контракту. Проверка уже готового dict не обнаружит исчезнувшее первое вхождение. Обрабатывать нужно каждый вложенный объект, а не только самый внешний уровень сообщения.

Пример

Объект содержит два одинаковых имени«role» с разными значениями. Почему проверка len готового словаря ненадёжна для поиска повтора?

Декодер мог уже заменить первое значение последним. В готовом словаре останется один ключ, и история повторения не восстановится без исходных пар.

Какие совпадения действительно являются повтором

Имена сравнивают после декодирования строковых экранирований. Буква a и её Unicode-экранированная запись обозначают одно имя, хотя байты исходного JSON различаются. Простого поиска одинаковых фрагментов в сыром тексте недостаточно. Сначала парсер должен корректно разобрать строковые имена, затем применяется правило уникальности.

Разные регистры обычно остаются разными именами: «Name» и«name» не сливаются самим JSON. Если приложение дополнительно нормализует ключи, оно должно проверять и коллизии после такого преобразования. Нельзя молча менять написание полей, оставляя неоднозначный выбор значения. Надёжный контракт описывает допустимые имена, уникальность и поведение при ошибке; отправитель получает понятный отказ вместо случайной зависимости от версии декодера.

От чтения к действию

А теперь — вы

Где надёжнее отклонить повторяющиеся имена JSON-полей?

Частые вопросы

Повтор поля гарантированно создаёт массив?

Нет. Такой переносимой семантики нет; получатели обрабатывают повтор по-разному.

Повтор можно обнаружить после обычного превращения в dict?

Не всегда. Часть вхождений могла уже быть потеряна, поэтому проверяют исходные пары при разборе.

Источники и работа с материалом

Объяснение, примеры и вопросы написаны для erudeet. Факты и определения сверены по источникам ниже; это ссылки для самостоятельной проверки.

Продолжить разбираться