# Неожиданный символ в JSON: что значит «looking for beginning of value» и как исправить

> Исправить неожиданный символ в JSON: пропущенные значения, лишние знаки и невидимые пробелы, что пишут парсеры и как найти виновника.

- Адрес: https://jsonstatham.dev/ru/errors/unexpected-character/
- Язык: Русский (ru)
- Английская версия: https://jsonstatham.dev/errors/unexpected-character.md
- Обновлено: 2026-11-08

Парсер ждал значение и получил что-то другое. Гадать, что ты имел в виду, он не будет. Это ошибка «на всё остальное»: символ, с которого не начинается значение и который не подходит ни под одну более точную ошибку, и нередко его даже не видно.

## Три способа получить неожиданный символ

Пропущенное после двоеточия значение, лишняя запятая, оставившая пустое место, и неразрывный пробел, скопированный со страницы. Третья строка выглядит нормально, потому что виновник невидим: перед `"Owl"` стоит U+00A0.

```json
{"callsign": "Owl", "ready": }
[1,,2]
{"callsign": "Owl"}
```

Исправлено: значение подставлено (или ключ убран), пустое место убрано, неразрывный пробел заменён обычным:

```json
{"callsign": "Owl", "ready": null}
[1, 2]
{"callsign": "Owl"}
```

Пропущенное значение — часто шаблон, чья подстановка вышла пустой: `"ready": {{ready}}` без значения. А если неожиданный символ — `<` в самом начале, разбирается HTML-страница, а не JSON: у этого случая [своя страница](https://jsonstatham.dev/ru/errors/unexpected-token/).

## С чего может начинаться значение JSON (RFC 8259)

[RFC 8259, раздел 3](https://www.rfc-editor.org/rfc/rfc8259#section-3) перечисляет семь видов значений, и у каждого известный первый символ: `{` — объект, `[` — массив, `"` — строка, цифра или `-` — число, `t`, `f`, `n` — три литерала. [Раздел 2](https://www.rfc-editor.org/rfc/rfc8259#section-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: недопустимое значение» |
| [Валидатор](https://jsonstatham.dev/ru/validator/) JSON Statham | Неожиданный символ, строка 1, колонка 6 | Неожиданный символ, строка 1, колонка 6: «там, где ожидалось значение» |

## Невидимые символы, которые ломают JSON

Если сообщение цитирует что-то похожее на пробел или вовсе пустоту, это один из этих символов. Внутри строки каждый из них безобиден, между токенами — смертелен.

| Символ | Код | Откуда берётся |
| --- | --- | --- |
| Неразрывный пробел | U+00A0 | Веб-страницы, текстовые редакторы, Option+пробел на клавиатуре Mac |
| Пробел нулевой ширины | U+200B | Текст со страниц, из мессенджеров и визуальных редакторов |
| Метка BOM не в начале | U+FEFF | Склеенные файлы, у каждого [свой BOM](https://jsonstatham.dev/ru/errors/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

```js
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

```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

```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)

```java
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)

```csharp
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

```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`](https://www.php.net/manual/ru/function.json-validate.php) появился в PHP 8.3.

## Как избежать неожиданных символов

- **Собирать JSON сериализатором.** Шаблон с пустой подстановкой или выпавшим элементом оставляет `: }` и `,,`; сериализатор так не умеет.
- **Проверять, что пришло.** Перед разбором ответа смотреть на статус и `Content-Type`: страница ошибки не станет JSON, что бы ни обещал адрес.
- **Вставлять через простой текст.** Копирование со страниц и из мессенджеров приносит U+00A0 и U+200B. Сначала вставить в валидатор — он их назовёт.
- **Удалять элементы целиком.** Ручное удаление элемента — источник `[1,,2]` и `{"a": }`; [форматирование](https://jsonstatham.dev/ru/) после правки покажет пропуски.

## Назвать символ в валидаторе

[Попробовать: открыть пример с неожиданным символом в валидаторе](https://jsonstatham.dev/ru/validator/?sample=unexpected_character). Карточка цитирует символ, а невидимые называет словами: «неразрывный пробел (U+00A0)», «пробел нулевой ширины (U+200B)». Для `}`, `]` или `,` на месте значения она пишет иначе: «Найдено «}» там, где ожидалось значение». «Покажи» (F8) ставит курсор прямо на символ.

- [Unexpected token в JSON](https://jsonstatham.dev/ru/errors/unexpected-token/): `<!DOCTYPE` и другой HTML там, где ждали JSON.
- [Expecting value](https://jsonstatham.dev/ru/errors/expecting-value/): одно сообщение Python на любой символ, с которого не начинается значение.
- [Висячая запятая](https://jsonstatham.dev/ru/errors/trailing-comma/): запятая прямо перед `]` или `}` — отдельная ошибка.
- [Типографские кавычки](https://jsonstatham.dev/ru/errors/smart-quotes/) и [одинарные кавычки](https://jsonstatham.dev/ru/errors/single-quotes/): кавычки, которых JSON не принимает.
- [Все ошибки JSON](https://jsonstatham.dev/ru/errors/)

## Неожиданный символ в JSON: частые вопросы

### Что значит «looking for beginning of value» в Go?

Декодер ждал значение (объект, массив, строку, число, `true`, `false` или `null`) и нашёл символ в кавычках. `<` — это HTML, `}` или `,` — пропущенное значение, а «пустота» — невидимый символ: стоит напечатать его код.

### Как найти невидимый символ в JSON?

Взять позицию из ошибки и напечатать код символа в ней, как делают фрагменты выше, или вставить текст в валидатор: он называет U+00A0, U+200B и U+FEFF.

### Почему Python на всё это пишет «Expecting value»?

У декодера Python одно сообщение на «здесь не начинается значение». Позиция точная, формулировка — нет; подробнее — [Expecting value](https://jsonstatham.dev/ru/errors/expecting-value/).

### Можно ли неразрывный пробел в JSON?

Внутри строки — да, это обычный символ. Между токенами — нет: пробельные символы JSON — только пробел, таб, перевод строки и возврат каретки.
