ENRU

Unexpected token '<' в JSON: сервер прислал HTML-страницу

Обновлено

Ты просил JSON, а получил веб-страницу. SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON — так об этом сообщает V8 (Chrome, Edge, Node.js). Перевод: «неожиданный токен „<“, "<!DOCTYPE "... — невалидный JSON». Символ <, на котором парсер остановился, — первый символ HTML-документа. Чинить в JSON нечего: его там нет. Вопрос в том, почему сервер ответил страницей, и ответ на него — в самом ответе, а не в парсере.

В старых Node.js и Chrome то же самое звучит как Unexpected token < in JSON at position 0 — «неожиданный токен < в JSON на позиции 0». Firefox пишет unexpected character at line 1 column 1, Safari — Unrecognized token '<', Python — Expecting value: line 1 column 1 (char 0), Go — invalid character '<' looking for beginning of value; полный список — ниже. Позиция 0, колонка 1, char 0: неверен уже самый первый символ, значит, в теле ответа не испорченный JSON, а что-то совсем другое.

Читаем цитату: это начало тела ответа

Начиная с Node.js 20 V8 цитирует первые десять символов того, что ему передали, и ставит ..., если текст длиннее. Эта цитата — самая быстрая диагностика, ещё до любых инструментов:

Начало в кавычкахЧто пришлоЧто смотреть
"<!DOCTYPE "... или "<!doctype "...Целая HTML-страница: страница ошибки, форма входа или index.html твоего же приложенияКод статуса и итоговый адрес после редиректов
"<html> и перевод строкиHTML-страница без doctype. Так выглядят стандартные страницы 502 и 504 у nginxКод статуса; логи прокси и бэкенда
"<?xml vers"...Документ <?xml: ошибка веб-сервиса или объектного хранилищаАдрес, метод и учётные данные
"<br /> и перевод строкиПредупреждение или notice PHP, напечатанные перед JSONЖурнал ошибок PHP; в продакшене display_errors должен быть выключен
..."2, "bio": <b>hi</b>}"< в середине: тело — JSON, а внутри значения сырой HTMLКод, который собирает JSON; см. неожиданный символ
'I', "Internal S"..., 'N', "Not Found"Простой текст вместо HTML. История та же: сообщение об ошибке там, где должны быть данныеКод статуса
"undefined", "[object Object]"Ответа нет вовсе: в JSON.parse передали не то значение«"undefined" is not valid JSON»

На пустое тело сообщение другое — Unexpected end of JSON input, о нём отдельная страница.

RFC 8259 определяет текст JSON как JSON-text = ws value ws, а значение начинается с {, [, ", цифры, -, t, f или n. С < не начинается ничего, поэтому любой парсер, который следует стандарту, останавливается на первом же символе.

Смотрим, что пришло на самом деле

Отлаживать парсер бесполезно — смотреть нужно на ответ. Три места, от самого быстрого:

  1. DevTools. Вкладка Network, клик по упавшему запросу, раздел Response. Нужны статус, заголовок ответа Content-Type и 301 или 302 прямо перед запросом. Пункт Copy as cURL в контекстном меню запроса даёт тот же запрос с теми же cookie для терминала.
  2. curl. -i печатает строку статуса и заголовки над телом. -w выводит только запрошенные поля и не идёт по редиректам, так что редирект на вход виден как 302 с адресом назначения.
  3. Свой код. До разбора залогировать статус, тип, итоговый адрес и первые символы тела.
$ curl -sS -i https://example.com/api/users/42
HTTP/2 200
content-type: text/html; charset=utf-8

<!DOCTYPE html>
<html lang="en">

$ curl -sS -o /dev/null -w '%{http_code} %{content_type} %{redirect_url}\n' https://example.com/api/me
302  https://example.com/login?next=/api/me
const res = await fetch('/api/users/42');
const text = await res.text();
console.log(res.status, res.headers.get('content-type'), res.redirected, res.url);
console.log(text.slice(0, 200));

fetch проходит редиректы молча; заметить их помогают res.redirected и res.url. axios ещё тише: с настройками по умолчанию HTML-тело со статусом 200 вообще не вызывает ошибки, response.data просто становится строкой с HTML (проверено на axios 1.21). Ошибка всплывает позже — когда кто-то вызывает JSON.parse(response.data) или читает response.data.items и получает undefined. На 4xx и 5xx axios бросает Request failed with status code 500 («запрос завершился с кодом 500»), а HTML лежит в error.response.data.

Почему сервер отвечает на запрос JSON страницей HTML

  • 200, text/html, страница твоего же приложения. Запрос не дошёл до API. Сервер одностраничного приложения отвечает на любой неизвестный путь файлом index.html. Типичные причины: относительный адрес (fetch('api/users') со страницы /users/42 запрашивает /users/api/users), dev-сервер без прокси на бэкенд, незаданный базовый адрес (${apiBase}/users превращается в undefined/users) или data.json, который лежит не там, где его ищет код.
  • 200 после редиректа. Сессия истекла, и сервер отправил запрос на страницу входа. fetch прошёл по 302 и отдал форму входа в JSON.parse.
  • 401 или 403 с HTML. Раньше API ответил слой авторизации, файрвол или защита от ботов.
  • 404 с HTML. Не тот путь или не тот метод. Большинство фреймворков рисуют стандартную 404 страницей.
  • 500 с HTML. Необработанное исключение. Обработчик ошибок Express по умолчанию отвечает HTML-страницей; так же ведут себя Django и Rails в режиме отладки.
  • 502, 503 или 504 с HTML. Бэкенд упал или не успевает, и прокси, балансировщик или сеть доставки контента перед ним отдали свою страницу ошибки.
  • Вывод PHP перед JSON. При включённом display_errors предупреждение попадает в тело раньше вывода json_encode, и тело начинается с <br />.

Та же ошибка в других движках и языках

Каждый парсер спотыкается на <, отличаются только слова. Каждое сообщение ниже получено подачей одной и той же HTML-страницы парсеру указанной версии. Строки с пометкой «исходник» взяты из исходного кода движка — там, где сам движок запустить для проверки было нельзя. Firefox перечисляет свои сообщения в справочнике Mozilla.

Движок, проверенная версияСообщениеПеревод
Chrome 156, Node.js 20.20 и 25.1 (V8)SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON«Неожиданный токен „<“… — невалидный JSON». Так же в Edge; консоль может добавить впереди Uncaught (in promise)
Node.js 18.20 (V8 10.2)SyntaxError: Unexpected token < in JSON at position 0«Неожиданный токен < в JSON на позиции 0» — старая формулировка, до сих пор частая в ответах и логах
Firefox (исходник: SpiderMonkey)SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data«Неожиданный символ в строке 1, колонке 1 данных JSON»; то же из response.json()
Safari, JavaScriptCore из macOS 27.0.1SyntaxError: JSON Parse error: Unrecognized token '<'«Ошибка разбора JSON: нераспознанный токен „<“». Так же пишет React Native на JavaScriptCore
Safari, response.json() (исходник: WebKit)SyntaxError: The string did not match the expected pattern.«Строка не соответствует ожидаемому шаблону» — общий текст WebKit: ни JSON, ни <, ни позиции
React Native, Hermes (исходник)SyntaxError: JSON Parse error: Unexpected character: <«Ошибка разбора JSON: неожиданный символ <». Hermes — движок по умолчанию в современном React Native
Python 3.9.6 и 3.14.10, requests 2.32.5requests.exceptions.JSONDecodeError: Expecting value: line 1 column 1 (char 0)«Ожидалось значение: строка 1, колонка 1 (символ 0)». Обычный json.loads даёт json.decoder.JSONDecodeError с тем же текстом; см. Expecting value
Python, aiohttp 3.13.5aiohttp.client_exceptions.ContentTypeError: 200, message='Attempt to decode JSON with unexpected mimetype: text/html; charset=utf-8'«Попытка разобрать JSON с неожиданным типом содержимого». aiohttp проверяет Content-Type до разбора; после сообщения идёт адрес
Go 1.25.3, encoding/jsoninvalid character '<' looking for beginning of value«Недопустимый символ „<“ там, где начинается значение»; так же у json.Unmarshal и json.Decoder
Java, Jackson 2.20.1com.fasterxml.jackson.core.JsonParseException: Unexpected character ('<' (code 60)): expected a valid value (JSON String, Number, Array, Object or token 'null', 'true' or 'false')«Неожиданный символ „<“ (код 60): ожидалось допустимое значение». Дальше идёт line: 1, column: 1
Java, Gson 2.13.2com.google.gson.JsonSyntaxException: java.lang.IllegalStateException: Expected BEGIN_OBJECT but was STRING at line 1 column 1 path $«Ожидалось начало объекта, а встретилась строка». Gson читает <!DOCTYPE как строку без кавычек; так падает Retrofit с конвертером Gson
C#, System.Text.Json 10 (рантайм 10.0.14)System.Text.Json.JsonException: '<' is an invalid start of a value. Path: $ | LineNumber: 0 | BytePositionInLine: 0.«„<“ — недопустимое начало значения». Строки и байты считаются с 0; GetFromJsonAsync и ReadFromJsonAsync не проверяют Content-Type
C#, Newtonsoft.Json 13.0.4Newtonsoft.Json.JsonReaderException: Unexpected character encountered while parsing value: <. Path '', line 0, position 0.«При разборе значения встретился неожиданный символ: <»
PHP 8.5.12Syntax error«Синтаксическая ошибка». json_decode возвращает null, json_last_error() — 4; с JSON_THROW_ON_ERROR тот же текст приходит в JsonException
jq 1.7.1 и 1.8.2jq: parse error: Invalid numeric literal at line 1, column 10«Недопустимый числовой литерал в строке 1, колонке 10»: jq принимает <!DOCTYPE за испорченное число и останавливается на пробеле после него

Исправление: статус и Content-Type до разбора

Парсер — неподходящее место, чтобы узнавать о сбое запроса. Сначала — статус и Content-Type, а начало тела — в текст ошибки, чтобы следующий отчёт выглядел как «502 text/html: <html>…», а не «Unexpected token». Каждый фрагмент ниже прогнан на тестовом сервере, который отвечает JSON, HTML-страницей, HTML-ошибкой 500 и пустым 204.

JavaScript (fetch)

async function getJson(url, options) {
  const res = await fetch(url, options);
  const type = res.headers.get('content-type') ?? '';
  const text = await res.text();
  if (res.ok && type.includes('json')) return JSON.parse(text);
  throw new Error(`${res.status} ${type} from ${res.url}: ${text.slice(0, 200)}`);
}

Python (requests)

import requests

def get_json(url, **kwargs):
    r = requests.get(url, timeout=10, **kwargs)
    ctype = r.headers.get("Content-Type", "")
    if r.ok and "json" in ctype:
        return r.json()
    raise RuntimeError(f"{r.status_code} {ctype} from {r.url}: {repr(r.text[:200])}")

Go

func getJSON(url string, v any) error {
	resp, err := http.Get(url)
	if err != nil {
		return err
	}
	defer resp.Body.Close()
	body, err := io.ReadAll(resp.Body)
	if err != nil {
		return err
	}
	ct := resp.Header.Get("Content-Type")
	if resp.StatusCode >= 300 || !strings.Contains(ct, "json") {
		return fmt.Errorf("%s %s: %.200q", resp.Status, ct, body)
	}
	return json.Unmarshal(body, v)
}

Java (HttpClient и Jackson)

static JsonNode getJson(String url) throws IOException, InterruptedException {
    HttpResponse<String> resp = http.send(
        HttpRequest.newBuilder(URI.create(url)).build(),
        HttpResponse.BodyHandlers.ofString());
    String type = resp.headers().firstValue("Content-Type").orElse("");
    String body = resp.body();
    if (resp.statusCode() >= 300 || !type.contains("json")) {
        throw new IOException(resp.statusCode() + " " + type + ": "
            + body.substring(0, Math.min(body.length(), 200)));
    }
    return mapper.readTree(body);
}

C# (HttpClient)

static async Task<T?> GetJson<T>(HttpClient http, string url)
{
    using var resp = await http.GetAsync(url);
    var type = resp.Content.Headers.ContentType?.MediaType ?? "";
    var body = await resp.Content.ReadAsStringAsync();
    if (resp.IsSuccessStatusCode && type.Contains("json"))
        return JsonSerializer.Deserialize<T>(body);
    throw new HttpRequestException($"{(int)resp.StatusCode} {type}: {body[..Math.Min(body.Length, 200)]}");
}

PHP (curl)

function getJson(string $url): array
{
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    $type = (string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE);
    if ($status >= 300 || strpos($type, 'json') === false) {
        throw new RuntimeException("$status $type: " . substr($body, 0, 200));
    }
    return json_decode($body, true, 512, JSON_THROW_ON_ERROR);
}

Проверка типа ищет json в любом месте заголовка, а не точное application/json: так проходят и параметр charset, и типы вроде application/problem+json (формат ошибок из RFC 9457).

Чтобы не повторялось

Запасной маршрут приложения — отдельно от API. В nginx у /api/ должен быть свой location раньше общего try_files: тогда неверный путь API дойдёт до бэкенда и получит его 404, а не index.html:

location /api/ {
    proxy_pass http://backend;
}

location / {
    try_files $uri $uri/ /index.html;
}

При разработке API лучше проксировать через dev-сервер, чем позволять ему отдавать приложение на любой путь. Пример для Vite; у других dev-серверов есть такая же настройка:

// vite.config.js
export default {
  server: {
    proxy: { '/api': 'http://localhost:8080' },
  },
};
  • Ошибки API — в JSON. Общий обработчик ошибок, который ставит Content-Type: application/json и на 404, и на 500, превращает это сообщение в понятное.
  • Просить JSON явно. С заголовком Accept: application/json некоторые фреймворки, например Laravel, отвечают на 401 и ошибки валидации JSON-ом, а не редиректом на страницу входа.
  • Один базовый адрес и проверка при старте. Абсолютные пути вроде /api/users или единая настройка базы; если она пустая — останавливаться уже при запуске.
  • Одна обёртка на все вызовы. С getJson, как выше, проверку статуса не забыть, а в её ошибке уже есть диагноз.

Попробовать

Вставь начало тела в валидатор: он остановится на строке 1, колонке 1 и назовёт символ. Позицию из длинного сообщения, вроде at position 1234 или char 1234, поиск позиции превратит в строку и колонку.

Ещё по теме: Unexpected end of JSON input — пустое тело, Expecting value — то же со стороны Python, неожиданный символ — лишний символ внутри настоящего JSON, и все ошибки JSON.

Вопросы об ошибке Unexpected token

Что значит ошибка «Unexpected token»?

Перевод: «неожиданный токен „<“». Первый символ разбираемого текста — <, значит, это HTML или другая разметка, а не JSON. На запрос пришла веб-страница (страница ошибки, форма входа или index.html приложения), и код попытался прочитать её как данные.

Почему в сообщении «position 0»?

Позиция 0 — первый символ. Node.js 18 и более ранние пишут Unexpected token < in JSON at position 0; Node.js 20 и современный Chrome вместо позиции цитируют начало тела: "<!DOCTYPE "....

В браузере работает, а в скрипте падает. Почему?

Браузер отправляет cookie и сессию, скрипт обычно нет. Его перенаправляют на страницу входа или останавливает защита от ботов, и он разбирает эту страницу. Скопируй запрос браузера как cURL в DevTools и сравни заголовки.

Можно ли заставить парсер принять HTML?

Нет, и смысла в этом нет: данных в этой странице нет. Исправлять нужно адрес, сессию или сервер, а клиент должен сообщать статус и Content-Type, когда тело — не JSON.