Cannot read property в n8n: undefined в expressions и Code node¶

Обновлено: 2026-05-29

Ошибка Cannot read property появляется, когда выражение или JavaScript-код обращается к полю, которого нет во входных данных. Например, workflow ждёт $json.user.email, а фактически пришёл $json.customer.email или объект user пустой.

Быстрое решение¶

Используйте optional chaining и fallback-значения:

{{ $json.user?.email || $json.email || "" }}
{{ $json.message?.text || "Нет текста" }}

Почему поле пропало¶

• Webhook получил другой тип события.
• Set / Edit Fields с Keep Only Set удалил поле.
• IF/Switch отправил в ветку данные другой структуры.
• API вернул пустой массив или ошибку вместо объекта.
• Merge не нашёл совпадение и отдал пустой результат.

Алгоритм диагностики¶

1. Откройте execution и input ноды, где падает expression.
2. Скопируйте реальную структуру JSON, а не ожидаемую.
3. Проверьте каждую часть пути: есть ли user, потом email.
4. Добавьте Set / Edit Fields перед проблемной нодой и приведите схему к одному формату.
5. Добавьте IF, если сценарий должен обрабатывать пустой input отдельно.

Set / Edit Fields как защита¶

Лучше один раз нормализовать данные перед важной веткой, чем писать длинные expressions в каждой ноде. Например, создайте поле email из всех возможных источников, а дальше используйте только его.

Code node¶

const email = item.json.user?.email ?? item.json.email ?? null;
if (!email) {
  item.json.validation_error = 'email_missing';
}
return item;

Глубокая диагностика: что проверить до изменения workflow ¶

Для проблемы Cannot read property в n8n: undefined в expressions и Code node сначала зафиксируйте факты, а не меняйте ноды наугад. Откройте failed execution, найдите первую ноду, где входные данные ещё корректны, а выход уже отличается от ожидаемого. Сравните не только текст ошибки, но и item count, полный JSON, headers, status code, binary data и время выполнения.

• Запишите слой сбоя: данные, авторизация, API, нода, очередь, база, reverse proxy или AI-слой.
• Соберите минимальный воспроизводимый пример на одном item и отдельно прогоните batch из 3–5 items.
• Проверьте, не маскирует ли retry исходную ошибку: в истории executions смотрите первый, а не последний сбой.
• Если задействован внешний сервис, данные и execution history, сравните реальный request/response из n8n с рабочим запросом вне n8n, скрыв секреты.
• После исправления сохраните пример плохого payload в тестовом workflow или в runbook, чтобы не терять контекст.

Решение без побочных эффектов ¶

Правка должна быть минимальной: исправляйте только тот слой, где доказана причина. Для Cannot read property в n8n: undefined в expressions и Code node опасно одновременно менять credentials, mapping, retry и бизнес-логику: после этого сложно понять, что действительно помогло.

Контрольный список после исправления ¶

• один успешный и один проблемный пример проходят предсказуемо
• в execution видно, какие данные ушли дальше по цепочке
• ошибка больше не скрывается за общим сообщением вроде “workflow failed”
• alert отправляется владельцу workflow с ID execution и короткой причиной
• для внешних записей есть ключ идемпотентности: order_id, event_id, email+date или payload_hash

Диагностика по шагам: как не лечить симптом вслепую

Проблему Cannot read property в n8n: undefined в expressions и Code node лучше разбирать как incident, а не как случайную ошибку в одной ноде. Сначала соберите доказательства, затем меняйте настройки workflow.

Проверка за 7 минут

1. Откройте последний failed execution и сравните его с последним successful execution того же workflow.
2. Зафиксируйте входной item: сколько items пришло, какие поля отсутствуют, есть ли binary data.
3. Проверьте credentials отдельно: токен, scopes, refresh, базовый URL, права пользователя.
4. Повторите запрос из HTTP Request через curl/Postman с теми же headers и body.
5. Посмотрите, не сработали ли rate limits, timeout, proxy, SSL или блокировка по IP.
6. Если ошибка плавающая, добавьте временный лог в безопасное хранилище: execution_id, event_id, status_code, краткое тело ответа.

Правильный порядок исправления

После фикса

• запустите старый failed payload повторно на тестовой копии workflow;
• проверьте, что ошибка не превратилась в silent failure;
• добавьте ссылку на эту страницу в error workflow или alert-сообщение;
• для повторяющихся инцидентов используйте workflow уведомлений об ошибках.

{
  "execution_id": "exec_...",
  "workflow_id": "wf_...",
  "node_name": "node_with_symptom",
  "error_message": "точный текст ошибки без токенов",
  "input_item_id": "external_or_dedupe_id",
  "last_successful_run": "timestamp",
  "changed_before_error": ["credentials", "payload", "version", "env"]
}

Что читать дальше¶

Подробно про expressions — Выражения, про нормализацию — Set / Edit Fields, про объединение веток — Merge.