Неожиданный символ в JSON: что значит «looking for beginning of value» и как исправить
Обновлено
Парсер ждал значение и получил что-то другое. Гадать, что ты имел в виду, он не будет. Это ошибка «на всё остальное»: символ, с которого не начинается значение и который не подходит ни под одну более точную ошибку, и нередко его даже не видно.
Три способа получить неожиданный символ
Пропущенное после двоеточия значение, лишняя запятая, оставившая пустое место, и неразрывный пробел, скопированный со страницы. Третья строка выглядит нормально, потому что виновник невидим: перед "Owl" стоит U+00A0.
{"callsign": "Owl", "ready": }
[1,,2]
{"callsign": "Owl"}Исправлено: значение подставлено (или ключ убран), пустое место убрано, неразрывный пробел заменён обычным:
{"callsign": "Owl", "ready": null}
[1, 2]
{"callsign": "Owl"}Пропущенное значение — часто шаблон, чья подстановка вышла пустой: "ready": {{ready}} без значения. А если неожиданный символ — < в самом начале, разбирается HTML-страница, а не JSON: у этого случая своя страница.
С чего может начинаться значение JSON (RFC 8259)
RFC 8259, раздел 3 перечисляет семь видов значений, и у каждого известный первый символ: { — объект, [ — массив, " — строка, цифра или - — число, t, f, n — три литерала. Раздел 2 разрешает вокруг них четыре пробельных символа: пробел, таб, перевод строки, возврат каретки.
Всё прочее там, где должно начаться значение, неожиданно: } или , (значение пропущено), < или @ и пробелы Unicode, которые выглядят как пробелы, но не являются ими, например U+00A0. Ошибки узнаваемой формы получают свой диагноз: кавычки, комментарии, слова, числа.
Ошибка «неожиданный символ» в разных парсерах
Ввод: {"a":@} и {"a":}, плохой символ на индексе 5. Сообщения получены запуском парсеров 8 ноября 2026 года, у Firefox — по исходникам SpiderMonkey.
| Парсер | На {"a":@} | На {"a":} |
|---|---|---|
| Chrome 156, Node 24–25 (V8) | Unexpected token '@', "{"a":@}" is not valid JSON. Перевод: «неожиданный токен @, это не валидный JSON» | Unexpected token '}', "{"a":}" is not valid JSON. Перевод: «неожиданный токен }, это не валидный JSON» |
| Firefox (SpiderMonkey) | unexpected character. Перевод: «неожиданный символ» | unexpected character. Перевод: «неожиданный символ» |
| Safari 27 (JavaScriptCore) | JSON Parse error: Unrecognized token '@'. Перевод: «нераспознанный токен @» | JSON Parse error: Unexpected token '}'. Перевод: «неожиданный токен }» |
| Python 3.9–3.14 | Expecting value: line 1 column 6 (char 5). Перевод: «ожидалось значение: строка 1, колонка 6» | Expecting value: line 1 column 6 (char 5). Перевод: «ожидалось значение: строка 1, колонка 6» |
| Go 1.25–1.27 | invalid character '@' looking for beginning of value. Перевод: «недопустимый символ @ там, где ожидалось начало значения» | invalid character '}' looking for beginning of value. Перевод: «недопустимый символ } там, где ожидалось начало значения» |
| Java, Jackson 2.15–2.23 | Unexpected character ('@' (code 64)): expected a valid value (JSON String, Number, Array, Object or token 'null', 'true' or 'false'). Перевод: «неожиданный символ @: ожидалось допустимое значение» | Unexpected character ('}' (code 125)): expected a valid value (JSON String, Number, Array, Object or token 'null', 'true' or 'false'). Перевод: «неожиданный символ }: ожидалось допустимое значение» |
| C#, System.Text.Json 10 | '@' is an invalid start of a value.. Перевод: «@ не может начинать значение» | '}' is an invalid start of a value.. Перевод: «} не может начинать значение» |
| C#, Newtonsoft.Json 13 | Unexpected character encountered while parsing value: @. Path 'a', line 1, position 5.. Перевод: «при разборе значения встретился неожиданный символ @» | Unexpected character encountered while parsing value: }. Path 'a', line 1, position 5.. Перевод: «при разборе значения встретился неожиданный символ }» |
| PHP 8.3 | Syntax error. Перевод: «синтаксическая ошибка» | Syntax error. Перевод: «синтаксическая ошибка» |
| Rust, serde_json 1.0 | expected value at line 1 column 6. Перевод: «ожидалось значение» | expected value at line 1 column 6. Перевод: «ожидалось значение» |
| jq 1.7.1 | Invalid numeric literal at line 1, column 7. Перевод: «неверный числовой литерал» | Unmatched '}' at line 1, column 6. Перевод: «непарная }» |
| MySQL 8.4: столбец JSON | Invalid JSON text: "Invalid value." at position 5. Перевод: «неверный текст JSON: недопустимое значение» | Invalid JSON text: "Invalid value." at position 5. Перевод: «неверный текст JSON: недопустимое значение» |
| Валидатор JSON Statham | Неожиданный символ, строка 1, колонка 6 | Неожиданный символ, строка 1, колонка 6: «там, где ожидалось значение» |
Невидимые символы, которые ломают JSON
Если сообщение цитирует что-то похожее на пробел или вовсе пустоту, это один из этих символов. Внутри строки каждый из них безобиден, между токенами — смертелен.
| Символ | Код | Откуда берётся |
|---|---|---|
| Неразрывный пробел | U+00A0 | Веб-страницы, текстовые редакторы, Option+пробел на клавиатуре Mac |
| Пробел нулевой ширины | U+200B | Текст со страниц, из мессенджеров и визуальных редакторов |
| Метка BOM не в начале | U+FEFF | Склеенные файлы, у каждого свой BOM |
| Символ замены | U+FFFD | Байты, которые не были валидным UTF-8 и заменены при декодировании |
Парсеры показывают их по-своему. V8 печатает сам символ, поэтому Unexpected token ' ' с неразрывным пробелом выглядит как обычный пробел. Go до 1.26 печатает первый байт как букву Latin-1: 'Â' для U+00A0 и 'â' для U+200B; Go 1.27 пишет '\u00a0'. System.Text.Json называет первый байт, '0xC2', а Jackson даёт код, (code 160).
Как опознать неожиданный символ
Прежде чем что-то менять, нужно точно узнать, что это за символ: пропущенному значению нужно значение, невидимый пробел нужно удалить, а < требует другого запроса. Каждая функция ниже запущена на вводах выше и печатает код символа.
JavaScript
function explain(error) {
const m = /Unexpected token '(.)'/u.exec(error.message);
if (m === null) return error.message;
const hex = m[1].codePointAt(0).toString(16).toUpperCase().padStart(4, '0');
return `${error.message} (U+${hex})`;
}Python
import json
def explain(text):
try:
json.loads(text)
return "valid"
except json.JSONDecodeError as e:
ch = text[e.pos : e.pos + 1]
found = f"U+{ord(ch):04X}" if ch else "end of input"
return f"{e.msg} at line {e.lineno}, column {e.colno}: {found}"Go
import (
"encoding/json"
"errors"
"fmt"
"unicode/utf8"
)
func explain(data []byte) string {
var v any
err := json.Unmarshal(data, &v)
var syn *json.SyntaxError
if errors.As(err, &syn) && syn.Offset > 0 && int(syn.Offset) <= len(data) {
i := int(syn.Offset) - 1
for i > 0 && !utf8.RuneStart(data[i]) {
i--
}
r, _ := utf8.DecodeRune(data[i:])
return fmt.Sprintf("%v (byte %d, %U)", err, i+1, r)
}
return fmt.Sprint(err)
}Цикл отступает к началу символа: Go 1.27 сообщает Offset после многобайтового символа, старые версии — внутри него.
Java (Jackson)
import com.fasterxml.jackson.core.JsonLocation;
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
static String explain(ObjectMapper mapper, String text) {
try {
mapper.readTree(text);
return "valid";
} catch (JsonProcessingException e) {
JsonLocation at = e.getLocation();
return e.getOriginalMessage() + " at line " + at.getLineNr() + ", column " + at.getColumnNr();
}
}C# (System.Text.Json)
using System.Text.Json;
static string Explain(string text)
{
try
{
using var doc = JsonDocument.Parse(text);
return "valid";
}
catch (JsonException e)
{
return $"line {e.LineNumber + 1}, byte {e.BytePositionInLine + 1}: {e.Message}";
}
}PHP
function explain(string $text): string
{
if (json_validate($text)) {
return 'valid';
}
$start = strspn($text, " \t\r\n");
return json_last_error_msg() . ', first byte: 0x' . bin2hex(substr($text, $start, 1));
}PHP 8.3 позицию не сообщает, поэтому функция показывает первый значимый байт: 0x3c — это <, HTML-страница; 0xef начинает BOM. json_validate появился в PHP 8.3.
Как избежать неожиданных символов
- Собирать JSON сериализатором. Шаблон с пустой подстановкой или выпавшим элементом оставляет
: }и,,; сериализатор так не умеет. - Проверять, что пришло. Перед разбором ответа смотреть на статус и
Content-Type: страница ошибки не станет JSON, что бы ни обещал адрес. - Вставлять через простой текст. Копирование со страниц и из мессенджеров приносит U+00A0 и U+200B. Сначала вставить в валидатор — он их назовёт.
- Удалять элементы целиком. Ручное удаление элемента — источник
[1,,2]и{"a": }; форматирование после правки покажет пропуски.
Назвать символ в валидаторе
Попробовать: открыть пример с неожиданным символом в валидаторе. Карточка цитирует символ, а невидимые называет словами: «неразрывный пробел (U+00A0)», «пробел нулевой ширины (U+200B)». Для }, ] или , на месте значения она пишет иначе: «Найдено «}» там, где ожидалось значение». «Покажи» (F8) ставит курсор прямо на символ.
- Unexpected token в JSON:
<!DOCTYPEи другой HTML там, где ждали JSON. - Expecting value: одно сообщение Python на любой символ, с которого не начинается значение.
- Висячая запятая: запятая прямо перед
]или}— отдельная ошибка. - Типографские кавычки и одинарные кавычки: кавычки, которых JSON не принимает.
- Все ошибки JSON
Неожиданный символ в JSON: частые вопросы
Что значит «looking for beginning of value» в Go?
Декодер ждал значение (объект, массив, строку, число, true, false или null) и нашёл символ в кавычках. < — это HTML, } или , — пропущенное значение, а «пустота» — невидимый символ: стоит напечатать его код.
Как найти невидимый символ в JSON?
Взять позицию из ошибки и напечатать код символа в ней, как делают фрагменты выше, или вставить текст в валидатор: он называет U+00A0, U+200B и U+FEFF.
Почему Python на всё это пишет «Expecting value»?
У декодера Python одно сообщение на «здесь не начинается значение». Позиция точная, формулировка — нет; подробнее — Expecting value.
Можно ли неразрывный пробел в JSON?
Внутри строки — да, это обычный символ. Между токенами — нет: пробельные символы JSON — только пробел, таб, перевод строки и возврат каретки.