# Unexpected end of JSON input: пустой или обрезанный ответ

> Исправить Unexpected end of JSON input: отличить пустой ответ (204, no-cors, пустой файл) от обрезанного и обработать оба случая в коде.

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

`SyntaxError: Unexpected end of JSON input` — текст кончился раньше, чем значение JSON. Перевод: «неожиданный конец входных данных JSON». Парсер прочитал всё, что ему дали. Этого не хватило. Чаще всего ему не дали ничего: пустое тело ответа, 204, пустой файл или переменная. Реже текст оборвался на середине. Это разные ошибки, и первым делом их нужно различить.

## Где появляется и как звучит

V8 пишет так много лет, без изменений от Node.js 18 до Node.js 25. Когда падает `response.json()`, Chrome иногда ставит перед текстом имя метода: в прогонах на Chrome 156 один и тот же ответ 204 дал обе формы. Другие движки говорят по-своему:

| Движок, проверенная версия | Сообщение | Перевод |
| --- | --- | --- |
| Chrome 156, Node.js 18.20, 20.20 и 25.1 (V8) | `SyntaxError: Unexpected end of JSON input` | «Неожиданный конец входных данных JSON»: `JSON.parse('')` и `response.json()` на пустом теле |
| Chrome 156, `response.json()` | `SyntaxError: Failed to execute 'json' on 'Response': Unexpected end of JSON input` | «Не удалось выполнить json у Response: неожиданный конец входных данных JSON» |
| Chrome 156, `fetch` с `mode: 'no-cors'` | `SyntaxError: Unexpected end of input` | «Неожиданный конец ввода». Ответ непрозрачный, тело прочитать нельзя вообще |
| Firefox (исходник: SpiderMonkey) | `SyntaxError: JSON.parse: unexpected end of data at line 1 column 1 of the JSON data` | «Неожиданный конец данных в строке 1, колонке 1» |
| Safari, JavaScriptCore из macOS 27.0.1 | `SyntaxError: JSON Parse error: Unexpected EOF` | «Ошибка разбора JSON: неожиданный конец файла»; так пишет `JSON.parse` |
| Safari, `response.json()` (исходник: WebKit) | `SyntaxError: The string did not match the expected pattern.` | «Строка не соответствует ожидаемому шаблону» — общий текст WebKit для любой ошибки JSON в `fetch` |
| React Native, Hermes (исходник) | `SyntaxError: JSON Parse error: Unexpected end of input` | «Ошибка разбора JSON: неожиданный конец ввода» |
| Python 3.9.6 и 3.14.10 | `json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0)` | «Ожидалось значение: строка 1, колонка 1 (символ 0)»; см. [Expecting value](https://jsonstatham.dev/ru/errors/expecting-value/) |
| Go 1.25.3, `json.Unmarshal` | `unexpected end of JSON input` | «Неожиданный конец входных данных JSON» — и для пустого, и для обрезанного |
| Go 1.25.3, `json.Decoder` | `EOF` для пустого тела, `unexpected EOF` для обрезанного | «Конец файла» и «неожиданный конец файла»; различить их помогает `errors.Is(err, io.EOF)` |
| Java, Jackson 2.20.1 | `MismatchedInputException: No content to map due to end-of-input` | «Нечего отображать: входные данные кончились». Так у `readValue`; `readTree` вместо ошибки вернёт `MissingNode` |
| C#, System.Text.Json 10 (рантайм 10.0.14) | `JsonException: The input does not contain any JSON tokens. Expected the input to start with a valid JSON token, when isFinalBlock is true. Path: $ \| LineNumber: 0 \| BytePositionInLine: 0.` | «Во входных данных нет ни одного токена JSON». Так же падает `GetFromJsonAsync` на ответе 204 |
| PHP 8.5.12 | `Syntax error` | «Синтаксическая ошибка», код 4 — как у любой другой |
| jq 1.7.1 и 1.8.2 | ни сообщения, ни вывода, код выхода 0 | Пустой ввод для jq — ноль документов; с `jq -e` код выхода будет 4 |

Две библиотеки не жалуются вовсе: Gson 2.13.2 `fromJson("", Map.class)` и Newtonsoft.Json 13.0.4 `DeserializeObject` от пустой строки возвращают `null`, и ошибка переезжает на первую строку, которая этим результатом пользуется.

## Пусто или обрезано: сначала измерить

До разбора залогировать длину текста. Ноль — ничего не пришло; иначе текст оборвался. Последние символы покажут где.

```js
const res = await fetch(url);
const text = await res.text();
console.log(res.status, res.type, res.headers.get('content-length'), text.length);
console.log(JSON.stringify(text.slice(-80)));
```

### Длина 0: разбирать нечего

- **204 No Content.** По [RFC 9110](https://www.rfc-editor.org/rfc/rfc9110#section-15.3.5) ответ 204 «не может содержать контент», так что `response.json()` на нём падает всегда. Эндпоинты `DELETE` и `PUT` часто отвечают именно 204.
- **Непрозрачный ответ.** `mode: 'no-cors'` не чинит ошибку кросс-доменного запроса, а прячет ответ: статус 0, `type` равен `opaque`, тело пустое. Chrome тогда пишет `Unexpected end of input`. Разрешать источник нужно на сервере; см. [режимы запроса](https://developer.mozilla.org/ru/docs/Web/API/Request/mode).
- **Запрос `HEAD`.** У него никогда не бывает тела.
- **Ошибка без тела.** Некоторые серверы отвечают на 401, 404 или 502 совсем пустым телом. Статус нужно читать раньше тела.
- **Ответа нет вовсе.** `JSON.parse('')` от пустого поля формы, переменная окружения, прочитанная как пустая строка, пустой файл, удалённая cookie.

### Длина больше 0: текст оборвался

Обрезанный документ не всегда сообщает о «конце ввода». V8 пишет, что ожидал в месте, где кончился текст, поэтому сообщение зависит от того, где прошёл разрез:

| Текст кончается на | V8 (Node.js 25.1) | Python 3.9.6 и 3.14.10 |
| --- | --- | --- |
| `{"id": 42, "name":` | `Unexpected end of JSON input` — «неожиданный конец входных данных» | `Expecting value: line 1 column 19 (char 18)` — «ожидалось значение» |
| `[1, 2, ` | `Unexpected end of JSON input` — «неожиданный конец входных данных» | `Expecting value: line 1 column 8 (char 7)` — «ожидалось значение» |
| `{"items": [1, 2` | `Expected ',' or ']' after array element in JSON at position 15 (line 1 column 16)` — «после элемента массива ожидалась „,“ или „]“» | `Expecting ',' delimiter: line 1 column 16 (char 15)` — «ожидался разделитель „,“» |
| `{"id": 42, "name": "Ad` | `Unterminated string in JSON at position 22 (line 1 column 23)` — «незакрытая строка» | `Unterminated string starting at: line 1 column 20 (char 19)` — «незакрытая строка, начало в…» |

Главная примета — позиция: если она равна длине текста, парсер упёрся в конец. В проверке первый кусок большого ответа в Node.js длиной 65 377 символов дал `Expected ',' or '}' after property value in JSON at position 65377 (line 1 column 65378)` — «после значения свойства ожидалась „,“ или „}“». Кусок кончился, а JSON — нет. Подробно об обрезанных документах — на страницах [незакрытая скобка](https://jsonstatham.dev/ru/errors/unclosed-bracket/) и [незакрытая строка](https://jsonstatham.dev/ru/errors/unclosed-string/).

- **Разбор кусков вместо всего тела.** В Node.js `res.on('data')` отдаёт тело по частям. Их нужно собрать и разобрать один раз в `'end'` — или взять `fetch` и `res.json()`, которые дожидаются всего тела.
- **Соединение закрылось посреди ответа.** Сервер упал, прокси упёрся в таймаут или лимит размера. Сравнить `Content-Length` с полученной длиной и найти запрос в логе сервера.
- **Лог или терминал, обрезающие длинные строки.** JSON, скопированный из записи лога, часто неполный.
- **Файл, прочитанный посреди записи.**

## Исправление: «нет тела» — это случай, а не падение

Решить, что значит пустое тело для твоего кода (обычно `null` или «ничего не изменилось»), и проверять это до разбора. Обрезанное тело — настоящая ошибка: пусть падает, а в лог — длина. Каждый фрагмент прогнан на тестовом сервере с ответами 204, пустым 200, полным JSON и обрезанным.

### JavaScript

```js
async function readJson(res) {
  const text = await res.text();
  if (res.status === 204 || text.trim() === '') return null;
  return JSON.parse(text);
}
```

### Python (requests)

```python
def read_json(r):
    if r.status_code == 204 or not r.content.strip():
        return None
    return r.json()
```

### Go

```go
func decodeOptional(r io.Reader, v any) (bool, error) {
	err := json.NewDecoder(r).Decode(v)
	if errors.Is(err, io.EOF) {
		return false, nil
	}
	return err == nil, err
}
```

### Java (HttpClient и Jackson)

```java
static JsonNode readJson(HttpResponse<String> resp) throws IOException {
    String body = resp.body();
    if (resp.statusCode() == 204 || body.isBlank()) return null;
    return mapper.readTree(body);
}
```

### C#

```csharp
static async Task<T?> ReadJson<T>(HttpResponseMessage resp)
{
    var body = await resp.Content.ReadAsStringAsync();
    if (string.IsNullOrWhiteSpace(body)) return default;
    return JsonSerializer.Deserialize<T>(body);
}
```

### PHP

```php
function readJson(string $body): ?array
{
    if (trim($body) === '') {
        return null;
    }
    return json_decode($body, true, 512, JSON_THROW_ON_ERROR);
}
```

В shell-скриптах молчание jq на пустом вводе легко принять за успех. `curl --fail-with-body` выходит с кодом 22 на ответах 4xx и 5xx, а `jq -e` — с кодом 4, если результату не из чего было взяться:

```shell
curl -sS --fail-with-body https://example.com/api/report | jq -e .
```

## Как не допустить

- **API:** либо 204 без тела, либо 200 с телом JSON — и это записано в документации. 200 с пустым телом хуже обоих вариантов.
- **Клиенты:** ветвиться по статусу до чтения тела, а 204 считать `null`.
- **Никакого `no-cors`** для ответа, который нужно прочитать.
- **Большие данные:** передавать как [JSON Lines](https://jsonstatham.dev/ru/guides/json-lines/) или читать потоковым парсером, а не разбирать куски вручную.
- **Файлы:** писать во временный файл и переименовывать на место, чтобы читатель никогда не видел пустой или недописанный документ.

## Попробовать

Вставь текст в [валидатор](https://jsonstatham.dev/ru/validator/?sample=unclosed_object). Пустой ввод он так и назовёт пустым, а обрезанный документ — незакрытым объектом, массивом или строкой, со строкой и колонкой.

Ещё по теме: [Unexpected token '<'](https://jsonstatham.dev/ru/errors/unexpected-token/) — когда тело оказалось HTML, [пустой ввод](https://jsonstatham.dev/ru/errors/empty-input/), [Expecting value](https://jsonstatham.dev/ru/errors/expecting-value/) — для Python, и [все ошибки JSON](https://jsonstatham.dev/ru/errors/).

## Вопросы об Unexpected end of JSON input

### Что значит «Unexpected end of JSON input»?

Перевод: «неожиданный конец входных данных JSON». Парсер дошёл до конца текста раньше, чем получил целое значение. Обычно текст был пустым, иногда — обрезанным.

### Почему response.json() падает на ответе 204?

У ответа 204 по определению нет контента, а пустая строка — не JSON. Сначала проверить `res.status === 204` или прочитать тело через `res.text()` и разбирать только непустой текст.

### Пустая строка — это валидный JSON?

Нет. [RFC 8259](https://www.rfc-editor.org/rfc/rfc8259) определяет текст JSON как одно значение с необязательными пробелами вокруг, а в пустой строке значения нет. Две кавычки, `""`, — валидны: это строковое значение, которое просто пустое.

### Как отличить пустое тело от обрезанного?

Залогировать `text.length` до разбора. Ноль — пусто. Иначе сравнить с `Content-Length` и посмотреть на последние символы: тело, которое кончается без закрывающей `}` или `]`, обрезано.
