Hur fungerar BackgroundTasks?

Question

Accepted Answer

FastAPI:s **`BackgroundTasks`** låter dig köra arbete **efter att du har returnerat svaret** — så klienten får ett snabbt svar medan lätt uppföljningsarbete (att skicka ett e-postmeddelande, loggning, rensning) sker i bakgrunden. Det är inbyggt och enkelt, för lätta uppgifter.

## Använda 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
```

Injicera en `BackgroundTasks`-parameter och anropa `add_task(func, *args)`. FastAPI skickar svaret först, sedan kör de köade uppgifterna — så användaren behöver inte vänta på e-postmeddelandet.

## Flera uppgifter och användning med beroenden

```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 avgörande begränsningen: det är INTE för tungt/kritiskt arbete

```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)
```

## När du ska använda vad

```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)
```

## Varför det är viktigt

`BackgroundTasks` är ett bekvämt inbyggt verktyg för det vanliga behovet av att utföra uppföljningsarbete utan att låta klienten vänta — skicka ett välkomstmeddelande, skriva en logg, lätt rensning — för att förbättra svarstiderna för användaren.

Att förstå det är användbart för dessa vardagliga lättviktsfall eftersom det inte kräver någon extra infrastruktur.

Men **den viktigaste punkten** är att veta dess **begränsningar**: eftersom det körs i samma process som webbservern, erbjuder det ingen persistens (uppgifter går förlorade vid krasch/omstart), ingen återförsök, ingen schemaläggning, och är inte lämplig för tungt eller kritiskt arbete.

Att känna igen denna gräns — att använda `BackgroundTasks` för snabba, icke-kritiska, "brand-och-glömma"-uppgifter, och en verklig jobbkö som **Celery/ARQ** för varaktig, återförsökbar, schemalagd eller tungt bakgrundsarbete — är det viktiga omdömet som förhindrar det vanliga misstaget att förlita sig på BackgroundTasks för arbete som inte får gå förlorat, vilket gör denna viktiga praktiska kunskap för att bygga tillförlitliga applikationer.