Гайды

Почему 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 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →