Почему JSON невалидный (Unexpected token) — 3 причины, что ловят почти всех

Консоль краснеет: Unexpected token < in JSON at position 0 (или просто SyntaxError: Unexpected token). Ты смотришь в свой JSON — а там нет никакого <. В этом и подвох: сообщение показывает не туда. JSON почти всегда невалиден по одной из трёх причин, и вот они — от самой частой к редкой.
Симптом: SyntaxError, а строка вроде нормальная
Ошибка вылетает в момент JSON.parse(...) — или когда fetch сам пытается разобрать ответ. Текст пугает точным «position 0» или token <, но настоящая точка сбоя не всегда там, куда он тычет. Разбираем причины по очереди.
Причина 1 (самая частая): это вообще не JSON
Чаще всего сервер вернул тебе HTML, а не JSON. Запрос ушёл не туда, эндпоинт отдал страницу ошибки 404 или 500 — а она начинается с <!DOCTYPE html>. Вот твой загадочный < в «position 0».
- Как проверить: до разбора выведи сырой ответ —
const text = await res.text(); console.log(text). Увидишь<html>...— вопрос закрыт, JSON тут ни при чём. - Как починить: чини не парсинг, а запрос. Проверь URL, метод и статус ответа. Если прилетела 500 или 404 — сервер вернул HTML-заглушку, и парсить нечего, пока запрос не станет успешным. Это же частая причина, почему fetch возвращает undefined.
Причина 2: синтаксис в JSON, написанном руками
Если JSON ты составлял сам (конфиг, тело запроса), причина обычно в строгости формата. JSON не прощает того, что прощает JavaScript:
- хвостовая запятая:
{"a": 1,}— нельзя. - одинарные кавычки:
{'a': 1}— только двойные:{"a": 1}. - ключ без кавычек:
{a: 1}— надо{"a": 1}. - комментарии:
// комментвнутри JSON запрещены.
Как проверить: вставь текст в любой онлайн JSON-валидатор — он подсветит точную строку. Как починить: убери хвостовые запятые, переведи все кавычки в двойные, закавычь ключи. Подробнее про сам формат — в разборе что такое JSON.
Причина 3: ты парсишь то, что парсить не надо
Unexpected token u ... "undefined" или [object Object] — верный признак, что ты зовёшь JSON.parse на том, что уже не строка JSON:
- Данные уже распарсены.
fetchчерезawait res.json()отдаёт готовый объект — второйJSON.parseповерх него падает. То же с axios. - Ты парсишь
undefined— переменной с данными ещё нет.
Как проверить: console.log(typeof data) перед разбором. object — парсить уже не нужно; undefined — данные не пришли. Как починить: не парсить дважды. Либо res.json(), либо JSON.parse(await res.text()) — но не оба сразу.
А если ответ от ИИ — «почти JSON», но не парсится?
Частая беда: просишь модель вернуть JSON, а она добавляет пояснение до или после, либо оборачивает всё в блок кода. Формально это уже не чистый JSON. Лечится двумя способами: попросить в промпте «верни только JSON, без пояснений и без обрамления», а лучше — включить структурированный вывод: режим, где модель гарантированно отдаёт валидный JSON по твоей схеме.
Как быстрее всего найти, где именно ошибка?
Не гадай глазами — скорми текст машине. Любой онлайн JSON-валидатор (ищи «json validator») подсветит точную строку и символ, где формат сломался. Это тридцать секунд против получаса чтения. А если JSON генерит твой код — выведи в лог сырую строку прямо перед JSON.parse. Половина «загадок» разгадывается сразу, как только видишь, что реально пришло на вход.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





