Passo 1: Identifique o tipo de erro
Erros diferentes indicam causas diferentes:
Erro 502 (Bad Gateway): o servidor do n8n não conseguiu responder a tempo — pode ser sobrecarga ou fluxo travado em loop.
Erro de timeout: o processo está demorando demais para finalizar (muito comum em execuções grandes).
Erro em node específico: geralmente um node está com dados errados ou uma API conectada está fora do ar.
Exemplo:
“Bad Gateway (502)” → significa que o n8n tentou processar algo e não conseguiu concluir a resposta a tempo.
Normalmente é temporário, mas se persistir, há algo consumindo todos os recursos do container.
Passo 2: Veja se é um workflow ou todos os workflows
Apenas um workflow falhando: problema localizado — revise a lógica desse fluxo.
Pode haver um loop infinito, excesso de dados ou uma requisição que nunca retorna.Todos os workflows afetados: pode indicar sobrecarga geral da instância.
Nesses casos, o ideal é pausar as execuções, limpar filas ativas e acionar o suporte.
Passo 3: Analise o peso e a complexidade do workflow
Workflows muito grandes podem derrubar a instância mesmo que estejam “certos”.
Siga estas boas práticas:
Divida fluxos grandes em módulos menores.
Processe dados em lotes pequenos (ex: 100 a 200 registros por execução).
Evite loops diretos ou triggers sem controle (ex: Webhook chamando o mesmo fluxo).
Utilize “IF” ou “Wait” para evitar execuções em cascata.
Se possível, limite as execuções simultâneas e defina timeouts razoáveis.
Passo 4: Evite execuções manuais longas
Rodar manualmente workflows muito pesados pode gerar o erro 502.
Sempre que possível, execute automaticamente e monitore pelo painel de Executions do n8n.
Se notar execuções presas, interrompa antes que causem looping.
Passo 5: Isolar o problema
Para encontrar a causa exata:
Teste partes do fluxo separadamente (execute um trecho de cada vez).
Adicione nós de debug ou log para acompanhar onde trava.
Simplifique temporariamente o fluxo, removendo nós não essenciais.
Observe se o erro ocorre em uma integração específica ou no fluxo como um todo.
Assim, você reduz o impacto e entende exatamente o que está causando a instabilidade.
⚙️ Resumo rápido
Identifique o tipo de erro (502, timeout ou erro de node).
Verifique se afeta um ou todos os workflows.
Simplifique e modularize os fluxos.
Evite execuções manuais de longa duração.
Se continuar, acione o suporte técnico.
💬 Precisa de ajuda?
Se o problema persistir ou estiver afetando todos os workflows, fale com
📩 [email protected]
ou use o chat no app (somente para infra ativa).