Vercel e os trabalhos em segundo plano: como organizar filas, cron e tarefas longas

Publicado em 2026-11-14 por frfrand

Arquitetura prática para separar frontend, funções HTTP, jobs, filas e workers quando as tarefas não se encaixam no tempo de execução do Vercel.

Vercel e os trabalhos em segundo plano: como organizar filas, cron e tarefas longas

Vercel é uma boa opção para implantar front-ends e funções HTTP, mas uma função HTTP não é necessariamente um worker permanente. Se o seu aplicativo precisar gerar relatórios longos, processar milhares de documentos ou consumir uma fila de forma contínua, convém projetar a execução explicitamente.

1. Distinga quatro tipos de trabalho

| Necessidade | Padrão habitual | |---|---| | Resposta imediata | Função HTTP pequena | | Processamento desacoplado | Enfileirar trabalho e responder com identificador | | Execução periódica | Programador que ativa uma tarefa | | Processo que ouve uma fila o dia todo | Worker residente em serviço adequado para isso |

Uma função tem um tempo máximo de duração sujeito ao runtime, configuração e plano; excedê-lo causa um erro. Não afirme que todas as funções do Vercel têm o mesmo limite: os valores mudam com o Fluid Compute e o plano.

2. Projete tarefas retentativas

Para exportar milhares de linhas, o endpoint HTTP valida permissões, cria um registro job no PostgreSQL, publica uma mensagem na fila e responde 202 Accepted com o ID. O worker processa e atualiza estados como queued, running, completed e failed.

Os usuários consultam o status por meio de um endpoint; baixar o resultado deve usar armazenamento apropriado e uma URL com expiração se houver informações privadas.

3. Idempotência e falhas

Uma fila pode entregar mensagens mais de uma vez. Identifique cada tarefa, impeça cobranças ou comunicações duplicadas e defina retentativas com backoff. Registre a causa da falha e crie uma fila de erros para itens que esgotaram as tentativas. Mantenha segredos no servidor e verifique permissões antes de permitir consultar o resultado.

Se a tarefa durar minutos ou horas, não a mantenha artificialmente aberta dentro de uma requisição. Divida em blocos ou use um worker adequado ao tempo e memória necessários.

4. O que fazer com cron

Os jobs cron de uma plataforma geralmente disparam invocações, não garantindo que um processo de aplicação permaneça ativo entre execuções. Proteja o endpoint de cron, gerencie sobreposições e armazene um cursor ou marca do último trabalho; um processo reiniciado não deve repetir tudo.

5. Arquitetura híbrida

Uma arquitetura válida é: frontend Next.js na Vercel → API e PostgreSQL → fila Redis ou equivalente → worker em VPS. Você também pode manter a API na Vercel se seus tempos e limites se ajustarem ao seu aplicativo. Não introduza o Redis sem uma necessidade concreta: uma tabela de jobs no PostgreSQL pode ser suficiente no início.

Para implementar esta separação revise Vercel com backend e PostgreSQL no ArduMaker, ArduMaker frente a Vercel e automações e tarefas cron.

Perguntas frequentes

### Não posso executar trabalhos longos no Vercel? Alguns sim, desde que sejam respeitados os limites, a configuração e o comportamento do runtime.

Um cron equivale a um worker?

Não; um cron agenda execuções, enquanto um worker pode consumir trabalho continuamente.

O Redis é obrigatório?

Não; depende do volume, da semântica da fila e dos requisitos operativos.

Fontes: Limites do Vercel Functions e configurar duração.

  • Vercel
  • workers
  • cron
  • serverless
  • colas

Continuar lendo

Todos os artigos · Planos VPS