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.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 |
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, и ошибка переезжает на первую строку, которая этим результатом пользуется.
Пусто или обрезано: сначала измерить
До разбора залогировать длину текста. Ноль — ничего не пришло; иначе текст оборвался. Последние символы покажут где.
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, 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 — нет. Подробно об обрезанных документах — на страницах незакрытая скобка и незакрытая строка.
- Разбор кусков вместо всего тела. В 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 и посмотреть на последние символы: тело, которое кончается без закрывающей } или ], обрезано.