Чтобы понять, как настроить обработку ошибок в 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
- Создайте новый workflow.
- Поставьте Error Trigger первой нодой. Обработчик должен начинаться с этой ноды.
- Дайте имя, например
Error Handler. - Нажмите Save.
Один обработчик допускается использовать для нескольких workflow — правка в одном месте обслуживает все связанные процессы. Если в workflow уже стоит Error Trigger, по умолчанию этот workflow использует себя как обработчик собственных ошибок. А workflow с Error Trigger нужно публиковать; в интерфейсе это отдельное действие от сохранения, и его стоит проверить глазами в своём инстансе.
Ограничение по режиму: при ручном запуске обработчик не проверить. Error Trigger срабатывает только при автоматическом выполнении с ошибкой. Поэтому учебный сбой должен идти в автоматическом запуске, а не из кнопки Execute workflow в редакторе.
Назначьте Error Workflow в настройках основного workflow
- Откройте основной workflow.
- В меню workflow выберите Settings — откроется модальное окно настроек. [4]
- В поле Error Workflow (to notify when this one errors) выберите
Error Handler. - Нажмите 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 |
Порядок действий для автоматического запуска:
- Убедитесь, что основной workflow сохранён с выбранным Error Workflow и с расписанием в одну минуту.
- Опубликуйте workflow с расписанием: по справке расписание работает только у сохранённого и опубликованного workflow, а поле Error Workflow в настройках задаёт обработчик при сбое [5], [4].
- Опубликуйте
Error Handler— workflow с Error Trigger требует публикации [2]. - Дождитесь ближайшего минутного запуска основного workflow. Stop And Error свалит выполнение, n8n запустит
Error Handler. - Откройте список выполнений
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, три проверяемых поля совпали, учебная нода и учебное расписание сняты, связка в настройках осталась.
Источники
- Handle errors gracefully | Build | n8n Docsdocs.n8n.io
- Error Trigger | Nodes | n8n Docsdocs.n8n.io
- Stop And Error | Nodes | n8n Docsdocs.n8n.io
- Configure workflow settings | Build | n8n Docsdocs.n8n.io
- Schedule Trigger | Nodes | n8n Docsdocs.n8n.io

