Hvordan fungerer BackgroundTasks?

Question

Accepted Answer

FastAPI's **`BackgroundTasks`** lader dig køre arbejde **efter at returnere svaret** — så klienten får et hurtigt svar, mens let opfølgningsarbejde (afsendelse af e-mail, logning, oprydning) sker i baggrunden. Det er indebygd og enkelt, til lette opgaver.

## Brug af BackgroundTasks

```python
from fastapi import BackgroundTasks

def send_email(address: str, message: str):
    # slow-ish work that the client shouldn't wait for
    email_client.send(address, message)

@app.post("/signup")
def signup(user: User, background_tasks: BackgroundTasks):   # inject BackgroundTasks
    save_user(user)
    background_tasks.add_task(send_email, user.email, "Welcome!")   # queue it
    return {"message": "User created"}    # RESPONSE returns NOW; email sends AFTER
```

Injektér en `BackgroundTasks`-parameter og kald `add_task(func, *args)`. FastAPI sender svaret først, derefter kører de køede opgaver — så brugeren venter ikke på e-mailen.

## Flere opgaver og brug med afhængigheder

```python
@app.post("/order")
def create_order(order: Order, bg: BackgroundTasks):
    bg.add_task(send_confirmation, order.email)
    bg.add_task(update_analytics, order.id)     # multiple tasks run in order, after the response
    return {"status": "created"}
```

## Den afgørende begrænsning: det er ikke til tungt/kritisk arbejde

```text
BackgroundTasks runs IN THE SAME PROCESS as the web server:
  ✗ NO persistence — if the server crashes/restarts, queued tasks are LOST
  ✗ NO retries, scheduling, or distribution
  ✗ Heavy CPU work would still tie up the worker process
→ Good for: quick, non-critical, fire-and-forget tasks (emails, logging, light cleanup)
→ For heavy, critical, retryable, or scheduled jobs → use Celery / ARQ (a real task queue)
```

## Hvornår skal man bruge hvilken

```text
BackgroundTasks → simple, lightweight, best-effort work tied to a request (no extra infra)
Celery / ARQ    → durable, retryable, scheduled, distributed jobs (needs a broker/workers)
```

## Hvorfor det betyder noget

`BackgroundTasks` er et praktisk indebygd værktøj til det almindelige behov for at udføre opfølgningsarbejde uden at få klienten til at vente — afsendelse af velkomst-e-mail, skrivning af log, let oprydning — forbedring af svartider for brugeren.

At forstå det er brugbart til disse dagligdags lette tilfælde, da det ikke kræver ekstra infrastruktur.

Men **det vigtigste punkt** er at kende dets **begrænsninger**: fordi det køres i samme proces som webserveren, tilbyder det ingen persistens (opgaver går tabt ved nedbrud/genstart), ingen forsøg igen, ingen planlægning, og er ikke egnet til tungt eller kritisk arbejde.

Af erkende denne grænse — brug af `BackgroundTasks` til hurtige, ikke-kritiske, ild-og-glem-opgaver, og en reel taskqueue som **Celery/ARQ** til varige, genoprøvbare, planlagte eller tunge baggrundsopgaver — er den vigtigste vurdering, der forhindrer den almindelige fejl at stole på BackgroundTasks til arbejde, der ikke må gå tabt, hvilket gør denne vigtige praktiske viden til at bygge pålidelige applikationer.