Execuções e modo passo a passo: como achar exatamente onde o fluxo quebrou
O método de quatro passos para achar qualquer falha no n8n usando o histórico de execuções, e a ordem em que os nodes realmente rodam.
Resumo por IA
Resumo gerado por IA, revisado pela redação.
Toda vez que um fluxo roda, o n8n grava uma execução com o que entrou e o que saiu de cada node. É esse registro que transforma "não funcionou" em um diagnóstico de dois minutos. Somado à execução isolada de um node por vez, você consegue apontar exatamente onde o fluxo quebrou e com qual dado — sem chute. Este texto mostra o método que resolve praticamente qualquer falha.
Adicione ao Google NotíciasO que fica gravado
Cada execução guarda o caminho completo: quais nodes rodaram, em que ordem, quanto tempo levaram, o que cada um recebeu e o que devolveu. Quando algo falha, o node problemático fica marcado e você consegue abrir o dado exato que estava passando naquele instante.
Isso muda a natureza da depuração. Em vez de reproduzir o problema, você abre a execução em que ele aconteceu e olha.
O método em quatro passos
1. Abra a execução que falhou, não uma nova
O erro mais comum de quem está começando é rodar o fluxo de novo para "ver o que acontece". Se a falha depende de um dado específico — um pedido sem telefone, um nome com caractere estranho —, a nova execução pode passar sem problema e você não aprende nada.
Vá ao histórico, abra a execução que falhou e olhe o dado real que causou a falha.
2. Ache o primeiro node vermelho
Não o último: o primeiro. Um node que falha costuma derrubar os seguintes, e é fácil investigar o sintoma em vez da causa. O primeiro ponto de falha na ordem de execução é onde está o problema.
3. Compare o que ele recebeu com o que ele esperava
Abra o node e olhe o painel de entrada. Em quase todos os casos, a resposta está aí:
O campo que a expressão procura não existe naquele item.
O campo existe mas está vazio.
O valor veio como texto onde se esperava número, ou vice-versa.
Chegaram zero itens — o node anterior não devolveu nada, e o problema é lá atrás.
Zero itens de entrada é a causa mais subestimada. O node não falhou: ele não tinha o que processar. Nesse caso, o culpado é o node anterior, e frequentemente um filtro que não casou com nada.
4. Rode um node por vez
Depois de corrigir, execute apenas aquele node, com o dado que já está ali, em vez de rodar o fluxo inteiro. É mais rápido e não dispara efeitos colaterais — nada de enviar cinquenta e-mails de teste a cada tentativa.
A ordem em que os nodes rodam
Quando o fluxo tem mais de um caminho, a ordem importa para entender o histórico — e ela mudou de comportamento na versão 1.0.
Em fluxos criados a partir do n8n 1.0, cada ramo é executado por inteiro antes do próximo começar. A ordem entre os ramos segue a posição na tela: de cima para baixo, e quando dois ramos estão na mesma altura, o mais à esquerda primeiro.
Em fluxos criados antes da 1.0, o comportamento era outro: o n8n executava o primeiro node de cada ramo, depois o segundo de cada ramo, e assim por diante.
Isso tem uma consequência prática que surpreende: mover um node na tela pode mudar a ordem de execução. Se um ramo precisa terminar antes de outro começar — gravar antes de notificar, por exemplo —, não confie na posição visual. A ordem de execução pode ser ajustada nas configurações do fluxo.
Os três erros que mais aparecem
Credencial expirada. A mensagem fala em autenticação ou permissão. O fluxo funcionava e parou sozinho — típico de acesso que venceu. Reconecte a credencial.
Expressão apontando para campo inexistente. Resultado vazio ou erro de propriedade indefinida. Confira o painel de entrada: o campo pode ter mudado de nome do lado do serviço.
Falha só em alguns itens. Rodou 50 vezes, falhou em 3. Quase sempre é dado incompleto nesses registros específicos. Aqui a solução não é corrigir o fluxo, é ensiná-lo a lidar com a exceção — validar antes ou permitir que o item problemático siga sem derrubar o resto.
O hábito que evita a maioria das crises
Depure com o histórico enquanto constrói, mas lembre que ele é reativo: você só olha depois que alguém reclamou. Fluxo que roda em produção precisa avisar sozinho quando falha, e essa configuração é assunto de outra aula — mas vale saber desde já que ela existe, porque é a diferença entre descobrir o problema em minutos e descobrir pelo cliente.
Método: abra a execução que falhou, ache o primeiro node vermelho, compare entrada com expectativa, corrija e rode só aquele node. Resolve a esmagadora maioria dos casos.
Esta aula faz parte do Curso de n8n do zero ao avançado, com todas as aulas em portugues.
Perguntas frequentes
Como ver por que meu fluxo falhou no n8n?
Abrindo o histórico de execuções e selecionando a execução que falhou. Ela mostra quais nodes rodaram, qual quebrou e exatamente quais dados entraram e saíram de cada um — inclusive o registro específico que causou a falha.
Como executar apenas um node?
Selecionando o node e mandando executá-lo isoladamente. Ele roda com os dados que já estão na entrada, sem reprocessar o fluxo inteiro, o que evita disparar novamente envios e gravações durante os testes.
Em que ordem os nodes são executados?
Em fluxos criados a partir do n8n 1.0, cada ramo roda por inteiro antes do próximo, e a ordem entre ramos segue a posição na tela: do mais alto para o mais baixo, e da esquerda para a direita quando estão na mesma altura. Fluxos anteriores à versão 1.0 usam outra lógica, alternando node a node entre os ramos.
Por que o node não processou nada?
Porque recebeu zero itens. O node não falhou — não teve o que processar. A causa está no node anterior, e o suspeito mais frequente é um filtro cuja condição não casou com nenhum registro.
Por que o fluxo falha só às vezes?
Quase sempre por causa de dados que fogem do padrão em alguns registros: campo vazio, formato diferente, caractere inesperado. A correção não é ajustar o fluxo para o caso feliz, e sim tratar a exceção — validar antes ou permitir que o item problemático siga sem interromper os demais.
