Perguntas frequentes sobre n8n: solução de problemas e erros comuns

O fluxo de trabalho não é executado automaticamente

• Você clicou em Publish (no n8n 1.x, o botão Active)? Clicar apenas em Save não ativa os gatilhos.
• Você publicou novamente depois de fazer alterações?
• O horário do agendamento está correto? Veja a próxima pergunta.
• Confira em Executions se há registros de falha.

O horário do agendamento está 8 horas atrasado

O fuso horário do n8n não foi configurado; por padrão, ele usa UTC. Defina a variável de ambiente GENERIC_TIMEZONE=Asia/Taipei e reinicie, ou especifique o fuso horário em Settings → Timezone no fluxo de trabalho.

O URL do Webhook mostra localhost

Adicione o URL público à configuração de implantação:

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

(Versões anteriores à 2.30 do n8n usam WEBHOOK_URL.) Confirme também se N8N_HOST e N8N_PROTOCOL estão corretos. Consulte Hospedagem própria.

O Webhook retorna 404

• Ao usar Test URL, você precisa clicar primeiro em Listen for test event, e só é possível receber um evento.
• Ao usar Production URL, o fluxo de trabalho precisa estar publicado.
• Confirme se o método HTTP (GET / POST) corresponde à configuração.

Consulte Tutorial de Webhook.

Um nó é executado muitas vezes

O nó anterior gerou vários items, então o nó seguinte é executado uma vez para cada um. Se você não quiser execuções repetidas, ative Execute Once em Settings do nó ou use Aggregate primeiro para combinar os dados. Consulte Estrutura de dados e items.

Falha na autorização do Google: redirect_uri_mismatch

O URI de redirecionamento autorizado configurado no Google Cloud não corresponde ao OAuth Redirect URL mostrado pelo n8n. Copie o URL da tela de credenciais do n8n e cole-o por completo no Google Cloud. Se o n8n mostrar localhost, corrija primeiro a configuração do URL de implantação. Consulte Gerenciamento de credenciais.

A autorização do Google expira a cada poucos dias

Quando o app OAuth no Google Cloud está no modo "Testing", as autorizações têm um prazo de validade mais curto. Você pode publicar o app como uma versão de produção.

Erro de secure cookie ao conectar de outro computador

Isso acontece ao conectar por http:// (sem HTTPS) de um endereço que não seja localhost. Para uso em produção, configure HTTPS; apenas para testes na rede interna, você pode definir temporariamente N8N_SECURE_COOKIE=false.

Falta de memória (JavaScript heap out of memory)

Geralmente, isso acontece ao processar muitos dados de uma vez ou arquivos muito grandes:

• Use Loop Over Items para processar em lotes.
• Divida o fluxo em subfluxos (a memória é liberada quando o subfluxo termina).
• Mantenha apenas os campos necessários (ative Keep Only Set Fields em Edit Fields).
• Aumente a memória do host.

O banco de dados está ficando cada vez maior

Os registros de execução armazenam os dados completos de cada nó. Configure a limpeza automática:

EXECUTIONS_DATA_PRUNE=true
EXECUTIONS_DATA_MAX_AGE=168    # mantenha por 7 dias (unidade: horas)

Você também pode configurar em Settings do fluxo de trabalho para não salvar os dados de execuções bem-sucedidas.

A expressão mostra undefined ou um erro

• Execute primeiro os nós anteriores para que a prévia da expressão tenha dados.
• Use ?. para evitar erros quando um nível intermediário não existir: {{ $json.address?.city }}.
• Para ler um nó executado anteriormente, use $('Nome do nó') em vez de $json.

Consulte Tutorial de expressões.

O nó Code não consegue ler $env

Por padrão, o n8n 2.x impede que o nó Code leia variáveis de ambiente. Recomendamos armazenar os valores necessários como credenciais ou passá-los nos parâmetros do nó.

O fluxo de trabalho parou de funcionar depois de uma atualização

Confira nas notas da versão se há mudanças incompatíveis. Se não puder corrigir o problema imediatamente, volte a usar a versão anterior da imagem e restaure um backup do banco de dados (geralmente, não é possível reverter migrações do banco de dados, por isso o backup antes da atualização é importante). Consulte Backup e atualização.

Onde encontrar exemplos?

• A página Templates do site oficial do n8n tem milhares de modelos de fluxos de trabalho compartilhados pela comunidade, que você pode importar diretamente.
• O fórum oficial da comunidade n8n tem muitas perguntas e respostas; quando encontrar uma mensagem de erro, pesquise primeiro no fórum.

Atualizado 12 de outubro de 2026