Webhook работает в тесте, но молчит в production

Начните с адреса запроса

Сравните URL в вызывающем сервисе с Production URL узла Webhook. Тестовый адрес нужен для отладки и не заменяет рабочий. Убедитесь, что совпадают путь и HTTP-метод. Проверяйте на безопасном тестовом сценарии: повторный запрос к боевому webhook может повторно создать заказ или отправить сообщение.

Опубликована ли нужная версия

В n8n 2.x используется модель публикации workflow. Сохранённый черновик и опубликованная версия могут различаться. Проверьте опубликованную версию и её настройки. Для старой установки интерфейс может показывать переключатель Active — сверяйтесь с документацией своей версии.

Доступен ли сервер извне

Адрес localhost доступен только с той машины, где выполняется запрос. Внешнему сервису нужен ваш публичный адрес. Проверьте DNS, сертификат HTTPS, правила сетевого экрана и маршрут до reverse proxy. Не открывайте все порты ради проверки. Отсутствие записи в логах proxy и ошибка приложения — разные ветки диагностики.

Проверьте переменные своей версии

В текущей документации n8n переменная N8N_WEBHOOK_URL задаёт внешний адрес. WEBHOOK_URL отмечена как устаревшая начиная с 2.35.0. Для более ранней установленной версии сверяйтесь с её документацией: слепо менять имя переменной при миграции не стоит. Следующий пример относится к актуальному имени и одному reverse proxy.

N8N_WEBHOOK_URL=https://n8n.example.com/
N8N_PROXY_HOPS=1

example.com — пример, замените его своим доменом. Количество доверенных proxy должно соответствовать реальному маршруту. На последнем proxy должны передаваться X-Forwarded-For, X-Forwarded-Host и X-Forwarded-Proto. После изменения конфигурации примените её к контейнеру и проверьте отображаемый Production URL.

Сведите результат к одной гипотезе

Сохраняйте время запроса, код ответа и обезличенный фрагмент ошибки. Не публикуйте в обсуждениях токены, cookies и содержимое клиентских данных.

• Не приходит в proxy: проверьте адрес, DNS, сеть и вызывающую сторону.
• Доходит до proxy, но не до n8n: проверьте маршрут и upstream.
• Получаете 404: проверьте путь, метод и публикацию workflow.
• Получаете 401 или 403: проверьте настройки авторизации и ограничения доступа.
• Выполнение началось и завершилось ошибкой: диагностируйте конкретный узел по журналу n8n.