n8n 2.43.7: pausa de execuções ao desligar workers no modo fila

O n8n 2.43.7 acrescenta uma opção para pausar determinadas automações quando um worker é desligado. A execução pode ser retomada por outro worker a partir do estado salvo, em vez de depender exclusivamente de terminar antes do encerramento do processo. O recurso vem desativado por padrão e tem limites importantes.

O n8n conecta serviços em sequências de tarefas, chamadas workflows. No modo fila, workers são processos que executam essas tarefas. Essa separação permite distribuir o trabalho, mas exige cuidado quando um desses processos precisa parar durante uma atualização ou manutenção.

Como a pausa funciona entre duas etapas

Antes dessa opção, uma execução em andamento continuava até terminar ou até o processo ser encerrado à força. Segundo a alteração oficial, uma execução interrompida dessa maneira podia falhar definitivamente ao perder o bloqueio que a vinculava ao trabalho na fila.

Com N8N_WORKER_SUSPEND_EXECUTIONS_ON_SHUTDOWN=true, o worker solicita a pausa das execuções elegíveis no próximo limite entre nós, os blocos que representam cada etapa. O estado fica salvo como aguardando. O processo principal responsável pelo acompanhamento recoloca a execução na fila, normalmente em até cerca de 60 segundos, para outro worker continuar.

Quais execuções podem ser suspensas

A mudança contempla execuções de produção iniciadas por webhook, gatilho ou nova tentativa, desde que atendam aos critérios descritos na PR. Execuções manuais, avaliações, streaming, MCP e workflows com Chat Trigger habilitado ficam fora. Também não se pausa uma execução enquanto o processo principal ainda depende de seu resultado; em certos webhooks, a elegibilidade muda depois que a resposta já foi enviada.

Não é uma proteção contra qualquer interrupção. Se um nó demorar mais que a janela de desligamento ou ficar travado, o processo ainda poderá ser encerrado à força. A pausa acontece entre etapas, não no meio de uma operação externa em andamento.

O que testar antes de ativar

Em homologação, use dois workers e uma automação de produção com várias etapas. Solicite o desligamento de um worker durante uma etapa demorada e confira se ela termina, se a execução passa por aguardando e se o outro worker conclui o restante sem repetir os nós.

Teste separadamente um webhook que ainda precisa responder ao solicitante. Mantenha backup e confirme a atualização dos processos principais: a PR adota comportamento conservador quando eles ainda são antigos. Instalar a versão, sem habilitar a variável, mantém o comportamento anterior de desligamento.

Fontes oficiais desta versão