Jobs em Segundo Plano
Regras
- Descarregar trabalho lento para jobs em segundo plano: e-mails, processamento de imagens, webhooks, relatórios, chamadas de IA
- Usar BullMQ para filas Redis auto-gerenciadas — Inngest ou Trigger.dev para soluções serverless/gerenciadas
- Todo job deve ser idempotente — seguro para reexecutar sem efeitos colaterais (use chaves de idempotência)
- Retentar com backoff exponencial: 3-5 tentativas, com atrasos de 1s, 10s, 60s, 5min
- Fila de mensagens mortas (DLQ): após o máximo de retentativas, mover para DLQ para investigação — nunca descartar silenciosamente
- Definir limites de concorrência por fila — evitar sobrecarga do worker (ex.:
concurrency: 5)
- Payloads de jobs devem ser pequenos: passar IDs e referências, não objetos completos
- Separar filas por prioridade:
critical (pagamentos), default (e-mails), low (análises)
- Monitorar profundidade da fila e tempo de processamento — alertar quando a fila acumular
Padrões
import { Queue, Worker } from "bullmq";
const queue = new Queue("emails", { connection: redis });
await queue.add("welcome", { userId }, {
attempts: 3,
backoff: { type: "exponential", delay: 1000 },
});
const worker = new Worker("emails", async (job) => {
await sendWelcomeEmail(job.data.userId);
}, { connection: redis, concurrency: 5 });
import { inngest } from "./client";
export const sendEmail = inngest.createFunction(
{ id: "send-welcome-email", retries: 3 },
{ event: "user/created" },
async ({ event }) => { await sendWelcomeEmail(event.data.userId); }
);
Evitar
- Processar tarefas lentas em handlers de requisições de API — responder rápido, processar em segundo plano
- Jobs não idempotentes — execução duplicada causará cobranças duplicadas, e-mails duplicados
- Concorrência ilimitada — esgotará conexões de banco de dados e memória
- Armazenar payloads grandes na fila de jobs — passar referências