Как отлаживать воркфлоу в n8n: семь приёмов, если автоматизация не работает

· 2 мин чтения · Редакция Skill Unit

Сделать цепочку из узлов в n8n несложно. Сложнее разобраться, почему она вдруг остановилась или записала не те данные. Хорошая новость: в n8n есть удобные инструменты отладки, и в большинстве случаев причина находится за несколько минут. Ниже семь приёмов, которые стоит освоить с первого дня.

1. Смотрите данные на выходе каждого узла

Откройте узел после выполнения: слева видны входные данные, справа выходные. Большинство ошибок объясняется тем, что на вход пришло не то, что вы ожидали: пустое поле, другое имя поля, массив вместо одного значения. Сначала найдите первый узел, где данные стали неправильными, а не тот, где вылезла ошибка.

2. Закрепляйте данные (pin data)

Если первый узел получает данные от внешнего сервиса, например форму или webhook, каждый раз ждать новый запрос неудобно. Закрепите полученные данные в узле: n8n будет использовать их при тестовых запусках, и вы сможете сколько угодно раз перезапускать остальные узлы.

3. Запускайте по одному узлу

Выполните только нужный узел, а не весь воркфлоу. Так вы быстро проверите изменение и не отправите лишних писем и сообщений в боевые каналы.

4. Проверяйте выражения

Выражения в двойных фигурных скобках берут данные из предыдущих узлов. Частые ошибки: неверное имя поля, пропущенная точка, регистр букв, обращение к элементу массива, которого нет. Подведите курсор к выражению: n8n показывает, что оно вернёт на текущих данных. Если там пусто, ищите причину в пути к полю.

5. Следите за типами данных

  • Число и текст: «5» и 5 сравниваются по-разному.
  • Даты: разные форматы и часовые пояса ломают фильтры.
  • Пустые значения: условие «не равно» часто пропускает пустые поля.
  • Массивы: узел обработает каждый элемент отдельно, если вы не объединили их заранее.

6. Настройте обработку ошибок

Для критичных цепочек создайте отдельный воркфлоу с узлом Error Trigger: он запускается, когда другой воркфлоу падает, и может отправить вам сообщение с названием и текстом ошибки. В настройках узла есть режим продолжения при ошибке: используйте его осознанно, чтобы сбой одного шага не останавливал всё, но и не скрывал проблему.

7. Смотрите историю запусков

В списке выполнений (Executions) сохраняются запуски вместе с данными по узлам. Если ошибка случилась ночью, откройте нужный запуск и посмотрите данные в момент сбоя. Из неудачного запуска можно скопировать данные в редактор и повторить шаг.

Частые причины сбоев

  • Истёк токен или ключ доступа к внешнему сервису: переподключите учётные данные.
  • Сервис вернул ошибку лимита запросов: добавьте паузу или уменьшите частоту.
  • Изменился формат ответа внешнего API: проверьте поля на выходе узла.
  • Webhook не получает запросы: проверьте адрес, метод и то, что воркфлоу активирован.

Привычка, которая экономит часы

Давайте узлам понятные имена и добавляйте заметки. Через месяц вы не вспомните, что делает узел «HTTP Request 3», а «Получить заказ из CRM» понятен сразу. Это самая дешёвая отладка.

В курсе «Автоматизация без кода на n8n» мы собираем рабочие автоматизации шаг за шагом и учимся находить ошибки так, чтобы ничего не отправить лишнего. Первый урок бесплатный.

Хотите пройти путь на практике?

Курс «Автоматизация без кода на n8n»: короткие уроки, практические задания и проверка ответов. Первый урок бесплатно.

Смотреть курс