ENRU

Неожиданный символ в 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.14Expecting value: line 1 column 6 (char 5). Перевод: «ожидалось значение: строка 1, колонка 6»Expecting value: line 1 column 6 (char 5). Перевод: «ожидалось значение: строка 1, колонка 6»
Go 1.25–1.27invalid character '@' looking for beginning of value. Перевод: «недопустимый символ @ там, где ожидалось начало значения»invalid character '}' looking for beginning of value. Перевод: «недопустимый символ } там, где ожидалось начало значения»
Java, Jackson 2.15–2.23Unexpected 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 13Unexpected 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.3Syntax error. Перевод: «синтаксическая ошибка»Syntax error. Перевод: «синтаксическая ошибка»
Rust, serde_json 1.0expected value at line 1 column 6. Перевод: «ожидалось значение»expected value at line 1 column 6. Перевод: «ожидалось значение»
jq 1.7.1Invalid numeric literal at line 1, column 7. Перевод: «неверный числовой литерал»Unmatched '}' at line 1, column 6. Перевод: «непарная }»
MySQL 8.4: столбец JSONInvalid 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) ставит курсор прямо на символ.

Неожиданный символ в 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 — только пробел, таб, перевод строки и возврат каретки.