ENRU

Ошибки 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_characterUnexpected 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 0invalid_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, commentExpecting property name

Самые частые сообщения об ошибках JSON

Как читать сообщение об ошибке JSON

  1. Найди позицию. 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. Поиск позиции переводит любую из них в место в тексте.
  2. Смотри чуть раньше. Позиция — место, где парсер сдался. Пропущенная запятая отмечается на следующем значении, висячая — на скобке после неё, незакрытая скобка — в самом конце ввода.
  3. Исправляй по одной ошибке. Первая ошибка может порождать следующие; после исправления разбери текст снова.
  4. Проверь, что именно разбираешь. Если ошибка в строке 1, колонке 1, текст, скорее всего, вовсе не JSON: пустой ответ, HTML-страница, строка undefined.

Ошибки JSON: частые вопросы

Почему Chrome и Python пишут разное для одного и того же JSON?

Каждый парсер своими словами описывает, что ожидал там, где остановился. Причина одна; таблицы на страницах этого раздела ставят рядом точные сообщения всех основных парсеров.

Почему позиция ошибки стоит после настоящей ошибки?

Парсер понимает, что что-то не так, только прочитав символ, который не может идти дальше. Для висячей запятой это скобка после неё, для пропущенной — следующее значение, для незакрытой скобки — конец ввода.

Чем отличаются position, char и column?

Position у Chrome и char у Python считают символы от 0. Column считается от 1 внутри строки. Go, serde и System.Text.Json считают байты, поэтому любой символ вне базовой латиницы перед ошибкой сдвигает их числа.