O que é Timeout?

O que é timeout

Timeout é um limite de tempo aplicado a uma espera ou execução. Ele pode determinar quanto a aplicação aguardará uma conexão, a resposta de uma API ou a conclusão de um workflow antes de interromper aquela espera e seguir para o tratamento previsto.

Esse limite impede que um processamento aguarde indefinidamente, mas seu significado depende do escopo configurado. Um timeout de conexão e um timeout do workflow inteiro medem partes diferentes do trabalho e podem produzir resultados diferentes.

O que exatamente está sendo cronometrado

O valor configurado precisa ser interpretado junto do instante que inicia a medição e do evento que encerra a espera. Um intervalo sem receber novos bytes pode atingir um limite de inatividade, enquanto uma transferência que continua recebendo conteúdo ainda pode ultrapassar um limite de duração total. Confira qual desses comportamentos a ferramenta documenta.

O HTTP Request Node do n8n documenta seu timeout como a espera pelos headers e pelo início da resposta. Já a configuração de timeout do workflow se refere ao limite da execução, portanto os dois valores não devem ser interpretados como controles equivalentes.

A unidade também precisa ser conferida. Informar 30 em um campo que espera milissegundos representa uma espera muito diferente de trinta segundos, e um valor aparentemente razoável pode encerrar quase todas as chamadas se a unidade for interpretada incorretamente.

A espera terminou, mas o resultado pode ser desconhecido

Um timeout informa que o limite observado foi atingido. Ele não comprova que o servidor deixou de executar a ação, pois a chamada pode ter chegado e o processamento pode continuar depois que o cliente encerra sua espera.

Cancelamento precisa ser confirmado pelo mecanismo adequado

Encerrar a conexão local não garante o cancelamento do trabalho remoto. Alguns serviços oferecem uma ação específica para cancelar uma tarefa, mas ela também pode chegar depois de a tarefa terminar ou encontrar uma etapa que já não pode ser desfeita.

Por isso, a interface e o workflow precisam distinguir falha de espera de cancelamento confirmado. Mostrar que a ação foi cancelada apenas porque o navegador deixou de aguardar pode contradizer o estado real no serviço.

Várias camadas podem ter limites diferentes

A mesma chamada pode passar pelo navegador, por um proxy e pelo servidor que executa a tarefa. Uma dessas camadas pode encerrar a espera antes das outras, fazendo o cliente receber erro enquanto o processamento continua no destino.

Novas tentativas também consomem tempo. Três chamadas com limite de cinco segundos cada, somadas às pausas entre elas, podem ultrapassar o prazo total que você pretendia oferecer para a tarefa.

Como escolher e verificar o limite

Observe a duração das chamadas em condições representativas e o prazo útil do processo. Uma exportação longa pode precisar de processamento em segundo plano com acompanhamento de status, em vez de manter uma única conexão esperando durante toda a geração.

Teste uma resposta lenta e confira o que acontece no cliente e no destino depois do limite. Antes de configurar um retry, verifique como a integração reconhece efeitos já realizados e como informa uma pendência cujo resultado ainda não pôde ser confirmado.

Aplicação na formação

n8n Experts

O timeout limita a espera de uma etapa da automação e exige tratamento quando o resultado da chamada permanece desconhecido.

Conhecer a formação →