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

> Разобрать ошибку Unexpected token '<' в JSON: сервер прислал HTML вместо данных. Как проверить статус и Content-Type, найти причину и защитить код.

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

Ты просил 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`; [полный список](https://jsonstatham.dev/ru/errors/unexpected-token/#engines) — ниже. Позиция 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; см. [неожиданный символ](https://jsonstatham.dev/ru/errors/unexpected-character/) |
| `'I', "Internal S"...`, `'N', "Not Found"` | Простой текст вместо HTML. История та же: сообщение об ошибке там, где должны быть данные | Код статуса |
| `"undefined"`, `"[object Object]"` | Ответа нет вовсе: в `JSON.parse` передали не то значение | [«"undefined" is not valid JSON»](https://jsonstatham.dev/ru/errors/undefined-is-not-valid-json/) |

На пустое тело сообщение другое — `Unexpected end of JSON input`, о нём [отдельная страница](https://jsonstatham.dev/ru/errors/unexpected-end-of-json-input/).

[RFC 8259](https://www.rfc-editor.org/rfc/rfc8259) определяет текст 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. **Свой код.** До разбора залогировать статус, тип, итоговый адрес и первые символы тела.

```shell
$ 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
```

```js
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`](https://developer.mozilla.org/docs/Web/API/Response/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](https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Errors/JSON_bad_parse).

| Движок, проверенная версия | Сообщение | Перевод |
| --- | --- | --- |
| 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](https://jsonstatham.dev/ru/errors/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)

```js
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)

```python
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

```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)

```java
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)

```csharp
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)

```php
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](https://www.rfc-editor.org/rfc/rfc9457)).

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

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

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

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

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

```js
// 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`, как выше, проверку статуса не забыть, а в её ошибке уже есть диагноз.

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

Вставь начало тела в [валидатор](https://jsonstatham.dev/ru/validator/?sample=unexpected_character): он остановится на строке 1, колонке 1 и назовёт символ. Позицию из длинного сообщения, вроде `at position 1234` или `char 1234`, [поиск позиции](https://jsonstatham.dev/ru/json-position/) превратит в строку и колонку.

Ещё по теме: [Unexpected end of JSON input](https://jsonstatham.dev/ru/errors/unexpected-end-of-json-input/) — пустое тело, [Expecting value](https://jsonstatham.dev/ru/errors/expecting-value/) — то же со стороны Python, [неожиданный символ](https://jsonstatham.dev/ru/errors/unexpected-character/) — лишний символ внутри настоящего JSON, и [все ошибки JSON](https://jsonstatham.dev/ru/errors/).

## Вопросы об ошибке 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.
