Диагностика n8n: runbooks и быстрый выбор решения ¶

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

Короткий ответ ¶

Эта страница должна быть не просто списком ссылок, а диагностическим навигатором: пользователь описывает симптом, быстро понимает вероятную область сбоя и переходит в нужный гайд. Для SEO и LLM-ответов важно дать на этой странице короткие развилки: webhook, Docker, Telegram, OAuth, queue mode, AI Agent, RAG, Google Sheets, CRM и платежи. Тогда поисковик видит не “каталог страниц”, а полезную hub-страницу, которая связывает весь troubleshooting-кластер.

Как пользоваться диагностикой ¶

Начните не с названия ноды, а с симптома. Одна и та же ошибка может выглядеть по-разному: webhook не работает из-за reverse proxy, Telegram молчит из-за конфликта webhook/polling, а очередь зависла из-за Redis или worker. Если сразу открыть случайную страницу, можно чинить не тот слой.

Выберите ближайшее описание, сделайте первый тест и только потом переходите в полный гайд.

Быстрый выбор сценария ¶

Симптом	Первый тест	Открыть дальше
Внешний сервис не запускает workflow	проверить production URL через `curl`	`/diagnostics/webhook/`
n8n не стартует в Docker	`docker compose ps` и логи контейнера	`/diagnostics/docker/`
Telegram bot молчит	проверить token, webhook и polling	`/diagnostics/telegram/`
OAuth даёт `redirect_uri mismatch`	сравнить callback URL в n8n и приложении	`/diagnostics/oauth/`
Executions зависают	проверить Redis, worker и queue mode	`/diagnostics/queue-mode/`
AI Agent врёт или не вызывает tools	проверить prompt, tools и output parser	`/diagnostics/ai-agent/`
RAG не находит документы	проверить ingestion, chunks и metadata	`/diagnostics/rag/`
Google Sheets создаёт дубли	проверить ключ upsert и range	`/diagnostics/google-sheets/`
CRM создаёт дубли лидов	проверить external_id, телефон и email	`/diagnostics/russia-crm/`
Платёж прошёл, заказ не обновился	проверить payment_id/order_id и журнал	`/diagnostics/payments/`
Webhook ЮKassa повторяется	проверить `200 OK` и идемпотентность	`/diagnostics/yookassa/`

Три вопроса перед любой правкой ¶

Перед тем как менять ноды, задайте себе три вопроса:

Запуск вообще произошёл?
Если execution не появился, проблема до workflow: URL, trigger, schedule, credentials, proxy, внешний сервис.
Данные пришли в ожидаемом формате?
Если execution есть, но поля пустые, проблема в payload, expressions, item structure, binary data или преобразовании JSON.
Ошибка случилась во внешнем сервисе?
Если n8n дошёл до HTTP Request/CRM/таблицы, смотрите код ответа, права, rate limit, timeout и формат запроса.

Эти вопросы помогают не переписывать workflow целиком, когда нужно исправить один URL или одно поле.

Минимальный журнал диагностики ¶

Для каждой production-ошибки сохраняйте короткую карточку. Это ускоряет повторные разборы и помогает уникализировать контент сайта реальными кейсами.

Дата и время:
Workflow:
Execution ID:
Trigger:
Симптом:
Ожидаемый результат:
Фактический результат:
Код ошибки / HTTP status:
Изменение перед сбоем:
Что проверено:
Что исправлено:

Если вы ведёте такие карточки, через месяц появится база реальных инцидентов. Её можно использовать для FAQ, примеров, внутренних ссылок и LLM-блоков.

Как отличить инфраструктуру от логики workflow ¶

Инфраструктурные ошибки обычно проявляются до выполнения бизнес-нод: контейнер не стартует, webhook не доходит, Redis недоступен, Postgres не принимает подключение, reverse proxy отдаёт 404/502/504. Ошибки логики workflow появляются после запуска: неверное выражение, пустой массив, неправильный merge, дубль строки, неверная стадия CRM.

Разделяйте эти уровни в тексте и интерфейсе сайта. Пользователь с ECONNREFUSED не должен читать про prompt для AI Agent, а пользователь с дублирующимися строками Google Sheets не должен начинать с Docker logs.

Приоритеты: что чинить первым ¶

Если сбой влияет на деньги, заказы или персональные данные, начинайте с безопасного режима:

остановить автоматическое повторение опасной операции;
включить журналирование;
сохранить последние failed executions;
вручную сверить критичные записи;
только потом менять workflow.

Для некритичных сценариев можно быстрее экспериментировать, но всё равно делайте одно изменение за раз. Иначе невозможно понять, что именно помогло.

Как эта hub-страница помогает SEO ¶

Для индексации такая страница должна выполнять роль “карты решений”. Ей нужны не только карточки ссылок, но и уникальный текст: таблица симптомов, порядок диагностики, объяснение уровней ошибки, FAQ и список связанных гайдов. Тогда она не конкурирует с дочерними страницами, а усиливает их внутренними ссылками и помогает поисковику понять структуру раздела.

FAQ ¶

С чего начинать диагностику n8n?
С проверки, появился ли execution. Если запуска нет, ищите проблему в trigger, URL, schedule, proxy или внешнем сервисе. Если execution есть, смотрите данные и конкретную ноду ошибки.

Почему ручной запуск работает, а production нет?
Часто отличаются test и production URL, credentials, входные данные или режим выполнения. Сравните manual execution с реальным payload.

Как понять, что проблема в Docker?
Если контейнер перезапускается, не видит volume, не подключается к базе или сервис доступен только с хоста, начинайте с Docker logs и сетей.

Что делать с ошибками, которые повторяются раз в неделю?
Добавьте журнал инцидентов, алерты и контрольный workflow. Редкие ошибки часто связаны с rate limit, истечением токена, лимитами памяти или временной недоступностью внешнего API.

Нужно ли закрывать диагностические страницы от индексации?
Нет, если каждая страница решает отдельный интент и содержит уникальные примеры. Тонкие одинаковые страницы лучше расширить или объединить.