ENRU

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

Обновлено

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.1SyntaxError: 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.10json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0)«Ожидалось значение: строка 1, колонка 1 (символ 0)»; см. Expecting value
Go 1.25.3, json.Unmarshalunexpected end of JSON input«Неожиданный конец входных данных JSON» — и для пустого, и для обрезанного
Go 1.25.3, json.DecoderEOF для пустого тела, unexpected EOF для обрезанного«Конец файла» и «неожиданный конец файла»; различить их помогает errors.Is(err, io.EOF)
Java, Jackson 2.20.1MismatchedInputException: 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.12Syntax 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, и ошибка переезжает на первую строку, которая этим результатом пользуется.

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

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

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 ответ 204 «не может содержать контент», так что response.json() на нём падает всегда. Эндпоинты DELETE и PUT часто отвечают именно 204.
  • Непрозрачный ответ. mode: 'no-cors' не чинит ошибку кросс-доменного запроса, а прячет ответ: статус 0, type равен opaque, тело пустое. Chrome тогда пишет Unexpected end of input. Разрешать источник нужно на сервере; см. режимы запроса.
  • Запрос 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, 2Expected ',' or ']' after array element in JSON at position 15 (line 1 column 16) — «после элемента массива ожидалась „,“ или „]“»Expecting ',' delimiter: line 1 column 16 (char 15) — «ожидался разделитель „,“»
{"id": 42, "name": "AdUnterminated 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 — нет. Подробно об обрезанных документах — на страницах незакрытая скобка и незакрытая строка.

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

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

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

JavaScript

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

Python (requests)

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

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)

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#

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

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, если результату не из чего было взяться:

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

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

  • API: либо 204 без тела, либо 200 с телом JSON — и это записано в документации. 200 с пустым телом хуже обоих вариантов.
  • Клиенты: ветвиться по статусу до чтения тела, а 204 считать null.
  • Никакого no-cors для ответа, который нужно прочитать.
  • Большие данные: передавать как JSON Lines или читать потоковым парсером, а не разбирать куски вручную.
  • Файлы: писать во временный файл и переименовывать на место, чтобы читатель никогда не видел пустой или недописанный документ.

Попробовать

Вставь текст в валидатор. Пустой ввод он так и назовёт пустым, а обрезанный документ — незакрытым объектом, массивом или строкой, со строкой и колонкой.

Ещё по теме: Unexpected token '<' — когда тело оказалось HTML, пустой ввод, Expecting value — для Python, и все ошибки JSON.

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

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

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

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

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

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

Нет. RFC 8259 определяет текст JSON как одно значение с необязательными пробелами вокруг, а в пустой строке значения нет. Две кавычки, "", — валидны: это строковое значение, которое просто пустое.

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

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