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. С < не начинается ничего, поэтому любой парсер, который следует стандарту, останавливается на первом же символе.
Смотрим, что пришло на самом деле
Отлаживать парсер бесполезно — смотреть нужно на ответ. Три места, от самого быстрого:
- DevTools. Вкладка Network, клик по упавшему запросу, раздел Response. Нужны статус, заголовок ответа
Content-Typeи 301 или 302 прямо перед запросом. Пункт Copy as cURL в контекстном меню запроса даёт тот же запрос с теми же cookie для терминала. - curl.
-iпечатает строку статуса и заголовки над телом.-wвыводит только запрошенные поля и не идёт по редиректам, так что редирект на вход виден как 302 с адресом назначения. - Свой код. До разбора залогировать статус, тип, итоговый адрес и первые символы тела.
$ 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/meconst 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.1 | SyntaxError: 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.5 | requests.exceptions.JSONDecodeError: Expecting value: line 1 column 1 (char 0) | «Ожидалось значение: строка 1, колонка 1 (символ 0)». Обычный json.loads даёт json.decoder.JSONDecodeError с тем же текстом; см. Expecting value |
| Python, aiohttp 3.13.5 | aiohttp.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/json | invalid character '<' looking for beginning of value | «Недопустимый символ „<“ там, где начинается значение»; так же у json.Unmarshal и json.Decoder |
| Java, Jackson 2.20.1 | com.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.2 | com.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.4 | Newtonsoft.Json.JsonReaderException: Unexpected character encountered while parsing value: <. Path '', line 0, position 0. | «При разборе значения встретился неожиданный символ: <» |
| PHP 8.5.12 | Syntax error | «Синтаксическая ошибка». json_decode возвращает null, json_last_error() — 4; с JSON_THROW_ON_ERROR тот же текст приходит в JsonException |
| jq 1.7.1 и 1.8.2 | jq: 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.