Hvordan fungerer BackgroundTasks?

Question

Accepted Answer

FastAPIs **`BackgroundTasks`** lar deg kjøre arbeid **etter at du har returnert responsen** — så klienten får et raskt svar mens lett oppfølgingsarbeid (sending av e-post, logging, opprydding) skjer i bakgrunnen. Det er innebygd og enkelt, for lette oppgaver.

## Bruke 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
```

Injiser en `BackgroundTasks`-parameter og kall `add_task(func, *args)`. FastAPI sender responsen først, kjører deretter de enkøede oppgavene — slik at brukeren ikke venter på e-posten.

## Flere oppgaver og bruk med avhengigheter

```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 avgjørende begrensningen: det er IKKE for tungt/kritisk arbeid

```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 skal bruke hva

```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 dette er viktig

`BackgroundTasks` er et praktisk innebygd verktøy for det vanlige behovet for å utføre oppfølgingsarbeid uten å la klienten vente — sending av velkomst-e-post, skriving av logg, lett opprydding — som forbedrer responstidene for brukeren.

Å forstå det er nyttig for disse daglige lette tilfellene siden det ikke krever ekstra infrastruktur.

Men det **viktigste punktet** er å kjenne **begrensningene**: fordi det kjøres i samme prosess som webserveren, gir det ingen persistens (oppgaver går tapt ved krasj/omstart), ingen gjenforsøk, ingen planlegging, og er ikke egnet for tungt eller kritisk arbeid.

Å gjenkjenne denne grensen — bruke `BackgroundTasks` for raskt, ikke-kritisk, brann-og-glem arbeid, og en reell jokkø som **Celery/ARQ** for varig, gjentakbar, planlagt eller tungt bakgrunnsarbeid — er nøkkelvurderingen som forhindrer den vanlige feilen med å stole på BackgroundTasks for arbeid som ikke må gå tapt, noe som gjør denne viktige praktiske kunnskapen for å bygge pålitelige applikasjoner.