Repetir a partir do nó falho: ele repete o efeito externo do nó falho e como você se protege contra isso?

Olá a todos. Estou pesquisando recuperação após falhas parciais em n8n e quero confirmar o comportamento além da documentação.

A documentação (Understand executions) diz que uma tentativa retoma do estado de execução salvo em vez de começar novamente do gatilho, nós concluídos mantêm seus resultados, e o nó que falhou processa cada item novamente, então um nó que enviou algumas mensagens antes de falhar as envia novamente. Ela também diz que um nó Execute Sub-workflow que falha reroda todo o sub-workflow.

O que gostaria de confirmar pela experiência:

  • Chamada única que atinge o serviço mas retorna um erro ou expira: a ação é realizada duas vezes na tentativa?
  • Nó multi-item que falha no item 3: os itens 1 e 2 são repetidos na tentativa?
  • Tentativa de API pública (POST /executions/{id}/retry, loadWorkflow verdadeiro ou falso): mesmo ponto de reinício que a UI?
  • Workflow de erro que aciona uma tentativa: alguma maneira de limitá-lo a uma tentativa?
  • Configuração do nó Retry On Fail versus a tentativa de execução: mesmo efeito em ações repetidas?

Por favor, diga qual versão do n8n e modo (regular ou fila) você testou, e se observou ou está citando a documentação. Qualquer padrão de proteção que você use (chave de idempotência, verificação de existência antes da ação, tabela de ids processados) também seria útil.

Obrigado.

Ei @faridd692, enquanto você espera por uma resposta, aqui estão algumas coisas que podem ajudar:

Recursos sugeridos

Automaticamente correspondido à sua pergunta.

Documentação:

Fórum:

@Joy_Ful, @Emmas, @Niffzy - vocês já ajudaram com problemas semelhantes, podem dar uma olhada?

Automaticamente sugerido pelo bot da comunidade n8n. É um piloto - compartilhe feedback aqui.

Oi @faridd692, bem-vindo à comunidade n8n.
Sim, tentar novamente uma chamada que expirou pode duplicar a ação se o serviço a tiver confirmado antes do timeout. Estou citando o código-fonte n8n@2.45.7 aqui, não relatando uma reprodução regular/fila. Para um nó HTTP/mensagem comum que para em caso de erro, a invocação falhada recebe sua entrada novamente, incluindo os itens 1 e 2. Retry On Fail (Repetir em Caso de Falha) repete dentro da mesma execução; execution retry (repetição de execução) cria uma nova execução usando o estado salvo.

A UI e a chamada de API pública usam o mesmo serviço de retry. loadWorkflow: true substitui as definições de workflow/nó usadas com esse estado salvo; false mantém as definições originais. Isso não altera o ponto de reinício para o trigger.

No seu Error Workflow, chame retry apenas quando execution.id existir e execution.retryOf estiver ausente. Se esse retry falhar, alerte em vez de tentar novamente. Mantenha Retry On Fail desabilitado se quiser apenas uma tentativa de nó adicional. Use uma chave de idempotência suportada pelo provedor por ação pretendida, por exemplo, o ID do evento original mais a ação e o destinatário/item, e reutilize-a em cada tentativa. Não baseie essa chave em $execution.id, que muda no retry de execução. Um nó de verificação de existência separado antes do nó falhado não será executado novamente antes dessa invocação repetida.

Handle errors gracefully | Build | n8n Docs

Oi @faridd692

Adicionando uma reprodução à explicação de @Deepankar: Testei n8n 2.45.7, modo regular, SQLite, HTTP Request 4.2, contra um serviço mock localhost. O modo de fila não foi testado.

Resultados observados:

  • O serviço registrou uma escrita, depois retornou 500 ou atingiu timeout: a tentativa de execução produziu uma segunda escrita.
  • Falha no item 3: o receptor registrou 1,2,3,1,2,3. O nó upstream concluído foi executado apenas uma vez.
  • Com um gráfico inalterado, API pública loadWorkflow: true, false, e o endpoint de tentativa da UI preservaram esse mesmo ponto de reinício.
  • Retry On Fail com maxTries: 2 repetiu o lote dentro de uma execução. A tentativa de execução criou uma nova execução.
  • Um nó Execute Sub-workflow com falha reexecutou o filho, incluindo seu marcador já concluído.
  • Um Error Workflow verificando que execution.id existe e execution.retryOf está ausente permitiu uma execução adicional. A tentativa com falha invocou o handler novamente, mas o IF impediu outra tentativa. Chamadores de tentativa concorrente ainda precisam de uma reivindicação atômica.

Ter o receptor mock aplicar a mesma chave de idempotência por ação gerou duas requisições, mas apenas uma escrita.

Um detalhe adicional de 2.45.7: Tive que publicar o Error Workflow antes de executá-lo. O handler não publicado não produziu execuções de handler; o carregador desta versão requer dados de workflow publicados.

Um caso que eu modelaria explicitamente é um resultado ambíguo: a API externa expira, mas a escrita pode já ter sido confirmada

Eu manteria essa operação em um estado de „resultado desconhecido

@faridd692 Na parte do modo de fila, li o lado do worker em n8n@2.45.7 (fonte novamente, não uma reprodução de fila). O worker carrega a execução de retry do banco de dados e a executa a partir da mesma pilha de nós salva, então o ponto de reinício e os itens repetidos são os mesmos que no modo regular.

Os dois eventos exclusivos da fila não reproduzem uma chamada concluída também. O Bull é configurado com maxStalledCount: 0, então um worker que morre no meio de um nó falha o job em vez de passá-lo para outro worker, e um worker não executará uma execução que já está marcada como travada. Um desligamento gracioso do worker pode estacionar um retry em execução, mas apenas em um limite de nó: o nó atual termina e outro worker continua a partir do próximo.

Depois de confirmar o reenvio, você está inclinado para lookup-before-create naquele nó, ou mover a escrita atrás de um armazenamento de idempotência fora do n8n para que um resume não possa bater duas vezes?