Как настроить обработку ошибок в n8n

Свяжите основной workflow с Error Workflow, вызовите контролируемый сбой через Stop And Error и сверьте поля данных с документацией. Учебный пример с контролем.

Чтобы понять, как настроить обработку ошибок в n8n, стоит начать с того, что связать основной workflow с обработчиком мало: пока вы не вызвали сбой и не сверили поля, неизвестно, что обработчик получит данные. Настроить обработку ошибок в n8n можно за один контролируемый проход [1]: отдельный workflow на Error Trigger, ссылка на него в настройках основного процесса и проверка через Stop And Error. Ручной запуск из редактора для этой проверки не подходит: Error Trigger реагирует на сбой при автоматическом выполнении.

Схема связки из двух workflow:

[Основной workflow] --ошибка--> [Error Handler]
 Schedule/Trigger     Error Trigger (первая нода)
 Node ...       дальше: разбор полей, уведомление
 Stop And Error (учебный сбой)

Обработчик начинает работу с Error Trigger и получает сведения о сбое. [2] Основной workflow ссылается на него в своих настройках. Пока этих двух связей нет, Stop And Error просто сорвёт выполнение, и разбирать данные будет нечем.

Создайте обработчик на Error Trigger

  1. Создайте новый workflow.
  2. Поставьте Error Trigger первой нодой. Обработчик должен начинаться с этой ноды.
  3. Дайте имя, например Error Handler.
  4. Нажмите Save.

Один обработчик допускается использовать для нескольких workflow — правка в одном месте обслуживает все связанные процессы. Если в workflow уже стоит Error Trigger, по умолчанию этот workflow использует себя как обработчик собственных ошибок. А workflow с Error Trigger нужно публиковать; в интерфейсе это отдельное действие от сохранения, и его стоит проверить глазами в своём инстансе.

Ограничение по режиму: при ручном запуске обработчик не проверить. Error Trigger срабатывает только при автоматическом выполнении с ошибкой. Поэтому учебный сбой должен идти в автоматическом запуске, а не из кнопки Execute workflow в редакторе.

Назначьте Error Workflow в настройках основного workflow

  1. Откройте основной workflow.
  2. В меню workflow выберите Settings — откроется модальное окно настроек. [4]
  3. В поле Error Workflow (to notify when this one errors) выберите Error Handler.
  4. Нажмите Save.

Частая ошибка: обработчик создан и сохранён, но в настройках основного процесса не выбран. Тогда сбой проходит мимо обработчика, и в логах ошибки видно только падение основного workflow.

Для проверки откройте настройки основного workflow повторно и убедитесь, что в Error Workflow стоит именно Error Handler, а не пустое поле.

Вызовите сбой через Stop And Error

Stop And Error принудительно валит выполнение в заданных вами условиях и запускает обработчик. [3] У ноды две операции по параметру Error Type:

  • Error Message — добавляется поле Error Message, куда пишете текст ошибки.
  • Error Object — добавляется поле Error Object, куда вписываете JSON-объект со свойствами ошибки.

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

Учебный пример

Основной workflow назовём Marketing Digest Test. Внутри одна ветка: Schedule Trigger → Stop And Error в режиме Error Message с текстом test_marketing_failure. Дополнительную ноду в обработчик не ставим: данных от самого Error Trigger хватает для сверки полей, а лишняя нода только добавит вход, который надо отдельно настраивать.

Входы учебного прогона целиком:

Шаг Что настраиваем Значение
Основной workflow, имя
имя процесса
Marketing Digest Test
Триггер
нода и параметры
Schedule Trigger, Trigger Interval — Minutes, Minutes Between Triggers — 1
Учебный сбой
нода и параметры
Stop And Error, Error Type — Error Message, Error Message — test_marketing_failure
Связка
Error Workflow в настройках основного workflow
Error Handler
Обработчик
первая и единственная нода
Error Trigger

Порядок действий для автоматического запуска:

  1. Убедитесь, что основной workflow сохранён с выбранным Error Workflow и с расписанием в одну минуту.
  2. Опубликуйте workflow с расписанием: по справке расписание работает только у сохранённого и опубликованного workflow, а поле Error Workflow в настройках задаёт обработчик при сбое [5], [4].
  3. Опубликуйте Error Handler — workflow с Error Trigger требует публикации [2].
  4. Дождитесь ближайшего минутного запуска основного workflow. Stop And Error свалит выполнение, n8n запустит Error Handler.
  5. Откройте список выполнений Error Handler и выберите последнее выполнение — в нём на выходе Error Trigger лежат данные о сбое.

Так выглядит заполненный результат для этого прогона:

[
  {
    "execution": {
      "id": "<номер выполнения основного workflow>",
      "url": "<адрес выполнения в вашем инстансе>",
      "error": {
        "message": "test_marketing_failure",
        "stack": "<стек ошибки>"
      },
      "lastNodeExecuted": "Stop And Error",
      "mode": "<режим выполнения>"
    },
    "workflow": {
      "id": "<id основного workflow>",
      "name": "Marketing Digest Test"
    }
  }
]

Угловые скобки — места, где значения зависят от вашего инстанса и прогона: их сверяем с фактическим выходом, а не подставляем из примера. Твёрдо проверяются три вещи: execution.error.message совпадает с test_marketing_failure, execution.lastNodeExecuted — это Stop And Error, workflow.name — Marketing Digest Test. execution.retryOf в первом запуске отсутствует: поле бывает только у повтора неудавшегося выполнения. execution.id и execution.url требуют сохранённой в базе записи о выполнении.

Сверьте данные о сбое с документацией

По умолчанию Error Trigger получает набор полей. Все сведения присутствуют всегда, кроме трёх:

  • execution.id — нужна сохранённая в базе запись о выполнении; отсутствует, если ошибка в триггерной ноде основного workflow, так как workflow не выполняется.
  • execution.url — по тем же условиям: нужна сохранённая запись и нет ошибки в триггерной ноде.
  • execution.retryOf — только у повтора неудавшегося выполнения.

Форма выхода выглядит так: объект execution с полями id, url, retryOf, error (message, stack), lastNodeExecuted, mode; рядом объект workflow с id и name [1].

Заполненная проверка для учебного примера:

Поле Что сверить Учебный результат
execution.error.message
текст из Stop And Error
test_marketing_failure
execution.lastNodeExecuted
имя упавшей ноды
Stop And Error
execution.id
есть, если выполнение сохранено
присутствует при сохранённой записи; пропустите, если сохранение выключено или сбой в триггере
execution.url
есть по тем же условиям, что id
присутствует вместе с id; иначе отсутствует
execution.retryOf
только у повтора
в первом запуске отсутствует
execution.mode
режим выполнения
manual в примере справки; в вашем автоматическом запуске сверьте значение по факту
workflow.name
имя основного workflow
Marketing Digest Test

Сверка идёт по факту выхода: если execution.id нет, проверьте, включено ли сохранение выполненных запусков в настройках workflow — параметр Save failed production executions в настройках отвечает за сохранение неудачных выполнений опубликованных workflow [4]. Заодно проверьте, не сидит ли ошибка в триггерной ноде. Если retryOf пуст, это нормальный первый запуск, а не дефект связки.

Проверьте сбой в триггерной ноде и ограничения запуска

Если ошибка вызвана триггерной нодой основного workflow, данные в обработчик приходят другого вида: в execution{} меньше информации, в trigger{} больше. Тогда проверять execution.id и execution.url бессмысленно — их не будет. Выход в этом случае содержит trigger.error с полями вроде name, cause, timestamp, message, node, а также trigger.mode со значением trigger; объект workflow приходит с пустыми id и name в примере справки [1].

Таблица различий:

Что проверяем Сбой в обычной ноде Сбой в триггерной ноде
Где больше данных
execution{}
trigger{}
execution.id
есть при сохранённой записи
отсутствует
execution.url
есть при сохранённой записи
отсутствует
trigger.error
нет
есть
trigger.mode
нет
trigger

Ограничение со стороны запуска: Error Trigger реагирует на автоматическое выполнение с ошибкой. Ручной запуск из редактора обработчик не вызывает, поэтому учебный сбой нужно пускать автоматически.

Ещё два случая остаются вне перехвата: workflow, который вообще не запускался, и workflow, который отработал без исключения, но без полезного результата. Error Trigger смотрит на падение выполнения, а не на пустой ответ на выходе. Такие ситуации закрывают отдельными проверками — например, нодой If после получения данных.

Уберите учебный сбой и оставьте обработчик

Чек-лист завершения:

  • Stop And Error удалён из основного workflow или отключён.
  • Учебное сообщение test_marketing_failure нигде не осталось.
  • Учебное расписание снято или заменено на рабочее: учебная минута не осталась в опубликованном workflow.
  • Error Workflow в настройках основного workflow по-прежнему указывает на Error Handler.
  • Error Handler сохранён и опубликован.
  • Основной workflow запускается штатно и не валится на учебной ноде.
  • В обработчике нет временной рассылки в рабочие каналы, если она там была для теста.

Отдельно про данные клиентов: прежде чем подключать к обработчику почту, Slack или CRM и тем более передавать туда содержимое сбоя, определите, что можно выносить за пределы n8n. В execution.error и trigger.error попадают текст ошибки и стек, а в lastNodeExecuted — имя ноды; настройка Redact production execution data прячет входные и выходные данные нод и заменяет их отметкой о скрытии [4]. Проверьте её до того, как данные сбоя уйдут во внешний сервис.

После этого обработчик остаётся связанным и готов принять реальный сбой. Дальше к нему добавляют уведомление в почту или Slack и разбор полей — это уже часть эксплуатации, а не проверки связки. Прежде чем расширять обработчик, стоит оценить, какие процессы вообще оправдывают такую обвязку: об этом — в материалах про окупаемость автоматизации и автоматизацию маркетинга.

Проверка результата в одну фразу: обработчик получил сообщение test_marketing_failure, три проверяемых поля совпали, учебная нода и учебное расписание сняты, связка в настройках осталась.

Источники

  1. Handle errors gracefully | Build | n8n Docsdocs.n8n.io
  2. Error Trigger | Nodes | n8n Docsdocs.n8n.io
  3. Stop And Error | Nodes | n8n Docsdocs.n8n.io
  4. Configure workflow settings | Build | n8n Docsdocs.n8n.io
  5. Schedule Trigger | Nodes | n8n Docsdocs.n8n.io

Валерий Курземнек

Автор метода «Машиночитаемый маркетинг»

Что ещё почитать