Hintergrundjobs
Regeln
- Langsame Arbeit in Hintergrundjobs auslagern: E-Mails, Bildverarbeitung, Webhooks, Berichte, KI-Aufrufe
- BullMQ für selbstgehostete Redis-Warteschlangen – Inngest oder Trigger.dev für serverlos/managed
- Jeder Job muss idempotent sein – sicher wiederholbar ohne Seiteneffekte (Idempotenzschlüssel verwenden)
- Wiederholung mit exponentiellem Backoff: 3-5 Versuche, Verzögerungen von 1s, 10s, 60s, 5min
- Dead Letter Queue (DLQ): nach maximalen Wiederholungen in DLQ verschieben zur Untersuchung – niemals still verwerfen
- Nebenläufigkeitsgrenzen pro Queue festlegen – Worker-Überlastung vermeiden (z.B.
concurrency: 5)
- Job-Payloads sollten klein sein: IDs und Referenzen übergeben, keine vollständigen Objekte
- Queues nach Priorität trennen:
critical (Zahlungen), default (E-Mails), low (Analysen)
- Queue-Tiefe und Verarbeitungszeit überwachen – warnen, wenn Queue sich staut
Muster
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); }
);
Vermeiden
- Langsame Aufgaben in API-Request-Handlern verarbeiten – schnell antworten, im Hintergrund verarbeiten
- Nicht-idempotente Jobs – doppelte Ausführung führt zu doppelten Kosten, doppelten E-Mails
- Unbegrenzte Nebenläufigkeit – erschöpft Datenbankverbindungen und Arbeitsspeicher
- Große Payloads in der Job-Warteschlange speichern – stattdessen Referenzen übergeben