Обработка ошибок

Настройка Error Workflows и graceful error handling в n8n

При разработке workflow важно предусмотреть обработку ошибок. Error Workflow позволяет контролировать реакцию n8n на сбои выполнения.

Типы ошибок

Тип	Описание	Пример
Node Error	Ошибка в конкретной ноде	Неправильные credentials
Trigger Error	Ошибка в триггере	Webhook недоступен
Memory Error	Нехватка памяти	Обработка больших файлов
Timeout	Превышение лимита времени	Долгий API запрос
Validation Error	Неверные данные	Отсутствует обязательное поле

Создание Error Workflow

Error Workflow запускается при сбое любого workflow, к которому он привязан.

Создайте новый workflow
Добавьте ноду Error Trigger как первую
Добавьте ноды для обработки ошибок (email, Slack и т.д.)
Сохраните workflow (например, “Error Handler”)
Привяжите к другим workflows

Привязка Error Workflow

Откройте workflow, для которого нужна обработка ошибок
Options → Settings
В поле Error workflow выберите созданный Error Handler
Сохраните

Данные об ошибке

Error Trigger получает подробную информацию о сбое:

Стандартная ошибка выполнения

[
  {
    "execution": {
      "id": "231",
      "url": "https://n8n.example.com/execution/231",
      "retryOf": "34",
      "error": {
        "message": "Example Error Message",
        "stack": "Stacktrace..."
      },
      "lastNodeExecuted": "HTTP Request",
      "mode": "manual"
    },
    "workflow": {
      "id": "1",
      "name": "My Workflow"
    }
  }
]

Поля данных

Поле	Описание	Доступность
`execution.id`	ID выполнения	Если сохранено в БД
`execution.url`	Ссылка на выполнение	Если сохранено в БД
`execution.retryOf`	ID оригинального выполнения	Только для retry
`execution.error.message`	Текст ошибки	Всегда
`execution.error.stack`	Stack trace	Всегда
`execution.lastNodeExecuted`	Нода с ошибкой	Всегда
`execution.mode`	Режим запуска	Всегда
`workflow.id`	ID workflow	Всегда
`workflow.name`	Название workflow	Всегда

Ошибка в триггере

Если ошибка произошла в триггере (не в обычной ноде), структура данных отличается:

{
  "trigger": {
    "error": {
      "name": "WorkflowActivationError",
      "message": "Connection refused",
      "cause": {
        "message": "ECONNREFUSED",
        "stack": "..."
      },
      "timestamp": 1654609328787,
      "node": { ... }
    },
    "mode": "trigger"
  },
  "workflow": {
    "id": "1",
    "name": "My Workflow"
  }
}

Примеры Error Workflows

Уведомление в Slack

┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│ Error Trigger│───→│  Set         │───→│    Slack     │
│              │    │ (формат msg) │    │              │
└──────────────┘    └──────────────┘    └──────────────┘

Сообщение в Slack:

:warning: *Ошибка в workflow*

*Workflow:* {{ $json.workflow.name }}
*Нода:* {{ $json.execution.lastNodeExecuted }}
*Ошибка:* {{ $json.execution.error.message }}
*Ссылка:* {{ $json.execution.url }}

Email уведомление

┌──────────────┐    ┌──────────────┐
│ Error Trigger│───→│    Gmail     │
│              │    │ Send Email   │
└──────────────┘    └──────────────┘

Логирование в базу данных

┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│ Error Trigger│───→│    Code      │───→│  PostgreSQL  │
│              │    │ (parse data) │    │  Insert Row  │
└──────────────┘    └──────────────┘    └──────────────┘

// Code нода для подготовки данных:
return [{
  json: {
    workflow_id: $json.workflow.id,
    workflow_name: $json.workflow.name,
    error_message: $json.execution.error?.message || $json.trigger?.error?.message,
    failed_node: $json.execution?.lastNodeExecuted || 'Trigger',
    execution_id: $json.execution?.id || null,
    timestamp: new Date().toISOString()
  }
}];

Принудительная ошибка: Stop And Error

Нода Stop And Error позволяет принудительно завершить workflow с ошибкой при определённых условиях.

Когда использовать

Валидация входных данных
Проверка бизнес-правил
Защита от некорректных состояний

Пример: Валидация заказа

┌────────────┐    ┌────────────┐    ┌────────────┐
│  Webhook   │───→│    IF      │───→│ Обработка  │
│  (заказ)   │    │(amount>0?) │    │  заказа    │
└────────────┘    └─────┬──────┘    └────────────┘
                        │
                   Нет ↓
               ┌────────────────┐
               │ Stop And Error │
               │ "Сумма должна  │
               │  быть > 0"     │
               └────────────────┘

Порядок выполнения веток

Изменение порядка

Options → Settings
Найдите настройку Execution Order
Выберите нужный режим

При одинаковой высоте веток — сначала выполняется левая.

Retry (Повторные попытки)

Автоматический retry

В настройках HTTP Request и некоторых других нод:

Settings → Retry On Fail: true
Settings → Max Tries: 3
Settings → Wait Between Tries: 1000ms

Ручной retry

Откройте Executions
Найдите failed execution
Нажмите Retry

Retry with same data
Retry with new data

Повторяет с теми же входными данными

Исследование ошибок

Способы анализа

Executions — просмотр всех выполнений
Log streaming — отправка логов во внешние системы
Error Workflow — кастомная обработка

Загрузка данных из прошлых выполнений

Откройте workflow
Найдите failed execution
Load data from previous execution
Отладьте проблему

Best Practices

1. Всегда настраивайте Error Workflow

┌─────────────────────────────────────────────┐
│              Продакшн Workflow               │
│                                              │
│  Settings:                                   │
│  ├─ Error workflow: Error Handler           │
│  └─ Save failed executions: Yes             │
│                                              │
└─────────────────────────────────────────────┘

2. Используйте информативные сообщения

// ❌ Плохо
throw new Error("Error");

// ✅ Хорошо
throw new Error(`Заказ ${orderId}: товар ${productId} отсутствует на складе`);

3. Разделяйте критичные и некритичные ошибки

┌──────────────┐    ┌──────────────┐
│ Error Trigger│───→│    Switch    │
└──────────────┘    └──────┬───────┘
                           │
          ┌────────────────┼────────────────┐
          ↓                ↓                ↓
    ┌──────────┐    ┌──────────┐    ┌──────────┐
    │ Critical │    │ Warning  │    │   Info   │
    │ (PagerD) │    │ (Slack)  │    │  (Log)   │
    └──────────┘    └──────────┘    └──────────┘

4. Включайте контекст

В сообщениях об ошибках указывайте:

Какой workflow упал
На какой ноде
Какие данные обрабатывались
Ссылку на execution

Связанные темы

Troubleshooting

Решение проблем — типичные ошибки

Executions

Выполнение workflows — история запусков

Логи

Logging — настройка логирования