Ошибки JSON: сообщения, причины, исправления
Обновлено
Сообщение парсера говорит, где он сдался, и редко — почему. Этот справочник сводит точные сообщения Chrome, Firefox, Safari, Python, Go, Java, C#, PHP и других парсеров к причинам за ними: по странице на причину, с переводом каждого сообщения, точными текстами всех парсеров и исправлением в коде.
«Невалидный» здесь значит невалидный по RFC 8259, стандарту JSON. У каждой причины есть код — тот же, который валидатор JSON показывает вместе со строкой и колонкой. Нашёл своё сообщение ниже? Страница рядом с ним его объясняет.
Запятые, двоеточия и кавычки
| Сообщение об ошибке | Код | Страница |
|---|---|---|
Expected double-quoted property name in JSON (Chrome), Illegal trailing comma before end of object (Python 3.13+) | trailing_comma | Висячая запятая |
Expected ',' or '}' after property value in JSON (Chrome), Expecting ',' delimiter (Python), Unexpected string in JSON (Node.js 18) | missing_comma | Пропущенная запятая |
Expected ':' after property name in JSON (Chrome), Expecting ':' delimiter (Python), invalid character '1' after object key (Go) | missing_colon | Пропущенное двоеточие |
Expecting property name enclosed in double quotes (Python), Single quotes (') are not allowed in JSON (Safari) | single_quotes | Одинарные кавычки |
Unexpected token '“' (Chrome), Unrecognized token '“' (Safari) | smart_quotes | Типографские кавычки |
Expected property name or '}' in JSON (Chrome), invalid character 'n' looking for beginning of object key string (Go) | unquoted_key | Ключ без кавычек |
Скобки и строки, которые не закрылись
| Сообщение об ошибке | Код | Страница |
|---|---|---|
Unexpected end of JSON input (Chrome, Go), Expected '}' (Safari), EOF while parsing an object (Rust) | unclosed_object | Незакрытая скобка: объект |
end of data when ',' or ']' was expected (Firefox), EOF while parsing a list (Rust) | unclosed_array | Незакрытая скобка: массив |
Expected ',' or ']' after array element для [1} (Chrome), State mismatch (invalid or malformed JSON) (PHP) | mismatched_bracket | Не та скобка |
Unterminated string in JSON at position (Chrome), Unterminated string starting at (Python) | unclosed_string | Незакрытая строка |
Чего в JSON нет
| Сообщение об ошибке | Код | Страница |
|---|---|---|
Unexpected token '/' (Chrome), Comments are not permitted in JSON. (Visual Studio Code) | comment | Комментарии |
Unexpected token 'N', "[NaN]" is not valid JSON (Chrome), Unexpected token 'T' для True (Chrome) | invalid_literal | Неверный литерал |
Unexpected number in JSON для 01, Unexpected token '.' для .5 (Chrome) | invalid_number | Неверное число |
Bad escaped character in JSON (Chrome), Invalid \escape (Python) | invalid_escape | Неверный escape |
Bad control character in string literal in JSON (Chrome), Invalid control character at (Python) | control_character | Управляющий символ |
Начало и конец документа
| Сообщение об ошибке | Код | Страница |
|---|---|---|
Unexpected end of JSON input на пустом вводе (Chrome), Expecting value: line 1 column 1 (char 0) (Python) | empty_input | Пустой ввод |
Unexpected UTF-8 BOM (decode using utf-8-sig) (Python), invalid character 'ï' looking for beginning of value (Go) | bom | Метка BOM |
Unexpected non-whitespace character after JSON (Chrome), Extra data (Python), invalid character '{' after top-level value (Go) | extra_data | Лишнее после JSON |
Maximum stack depth exceeded (PHP) | too_deep | Слишком глубокая вложенность |
Unexpected token '<', "<html>" is not valid JSON (Chrome), invalid character '<' looking for beginning of value (Go) | unexpected_character | Неожиданный символ |
Сообщения, у которых несколько причин
Некоторые сообщения вообще не о синтаксисе JSON: сервер прислал HTML, ответ пришёл пустым, значение разобрали дважды. Эти страницы начинают с сообщения и ведут к причине.
| Сообщение об ошибке | Код | Страница |
|---|---|---|
Unexpected token '<', "<!DOCTYPE "… is not valid JSON, Unexpected token < in JSON at position 0 | обычно unexpected_character | Unexpected token '<': HTML вместо JSON |
Unexpected end of JSON input, unexpected end of JSON input (Go) | empty_input или незакрытая скобка | Unexpected end of JSON input |
"undefined" is not valid JSON, "[object Object]" is not valid JSON, Unexpected token u in JSON at position 0 | invalid_literal | «undefined» is not valid JSON |
Expecting value: line 1 column 1 (char 0) (Python) | empty_input, unexpected_character и другие | Expecting value |
Expecting property name enclosed in double quotes (Python) | single_quotes, trailing_comma, unquoted_key, comment | Expecting property name |
Самые частые сообщения об ошибках JSON
Unexpected end of JSON input— «неожиданный конец ввода»: пустой или оборванный вводUnexpected token < in JSON at position 0— «неожиданный токен <»: пришла HTML-страница вместо JSONExpecting value: line 1 column 1 (char 0)— «ожидается значение»: Python получил пустоту или не JSONExpecting property name enclosed in double quotes— «ожидается имя свойства в двойных кавычках»: обычно одинарные кавычки"undefined" is not valid JSON— «undefined — невалидный JSON»:JSON.parse(undefined)Expected double-quoted property name in JSON at position— «ожидалось имя свойства в двойных кавычках»: обычно висячая запятаяExpected property name or '}' in JSON at position 1— «ожидалось имя свойства или }»: ключ без кавычек или одинарная кавычкаExpected ',' or '}' after property value in JSON— «после значения ожидалась , или }»: пропущенная запятаяUnterminated string in JSON at position— «незакрытая строка»: строка, которая не кончаетсяBad control character in string literal in JSON— «недопустимый управляющий символ в строке»: перевод строки или таб внутри строкиUnexpected non-whitespace character after JSON— «непробельный символ после JSON»: два документа в одномExtra data: line 1 column— «лишние данные»: то же в Python, часто JSON LinesUnexpected token u in JSON at position 0— «неожиданный токен u»:undefinedв старых Chrome и Node.jsJSON.parse: unexpected character at line 1 column 1 of the JSON data— «неожиданный символ»: Firefox, часто HTML
Как читать сообщение об ошибке JSON
- Найди позицию. Chrome даёт
position Nс отсчётом от 0 иline L column Cс отсчётом от 1; Python —line L column C (char N); Go — смещение в байтах вSyntaxError.Offset; System.Text.Json —LineNumberиBytePositionInLine, оба от 0. Поиск позиции переводит любую из них в место в тексте. - Смотри чуть раньше. Позиция — место, где парсер сдался. Пропущенная запятая отмечается на следующем значении, висячая — на скобке после неё, незакрытая скобка — в самом конце ввода.
- Исправляй по одной ошибке. Первая ошибка может порождать следующие; после исправления разбери текст снова.
- Проверь, что именно разбираешь. Если ошибка в строке 1, колонке 1, текст, скорее всего, вовсе не JSON: пустой ответ, HTML-страница, строка
undefined.
Ошибки JSON: частые вопросы
Почему Chrome и Python пишут разное для одного и того же JSON?
Каждый парсер своими словами описывает, что ожидал там, где остановился. Причина одна; таблицы на страницах этого раздела ставят рядом точные сообщения всех основных парсеров.
Почему позиция ошибки стоит после настоящей ошибки?
Парсер понимает, что что-то не так, только прочитав символ, который не может идти дальше. Для висячей запятой это скобка после неё, для пропущенной — следующее значение, для незакрытой скобки — конец ввода.
Чем отличаются position, char и column?
Position у Chrome и char у Python считают символы от 0. Column считается от 1 внутри строки. Go, serde и System.Text.Json считают байты, поэтому любой символ вне базовой латиницы перед ошибкой сдвигает их числа.