Hogyan működnek a BackgroundTasks?

Question

Accepted Answer

A FastAPI **`BackgroundTasks`** lehetővé teszi, hogy munka futhasson **a válasz visszaadása után** — így az ügyfél gyors választ kap, miközben könnyű követő feladatok (e-mail küldés, naplózás, takarítás) futnak a háttérben. Beépített és egyszerű, könnyű feladatokhoz.

## BackgroundTasks használata

```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áljon be egy `BackgroundTasks` paramétert és hívjon meg `add_task(func, *args)`. A FastAPI először elküldi a választ, majd futtatja a sorba helyezett feladat(oka)t — így a felhasználó nem vár az e-mailra.

## Több feladat és függőségekkel való használat

```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"}
```

## A döntő korlátozás: nem nehéz/kritikus munkához

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

## Mikor melyiket használja

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

## Miért fontos

A `BackgroundTasks` egy praktikus beépített eszköz az általános szükségletre — üdvözlő e-mail küldés, napló írás, könnyű takarítás — a felhasználó válaszidejének javítása.

A megértése hasznos ezen hétköznapi könnyű esetekhez, mivel nem igényel további infrastruktúrát.

De az **legfontosabb pont** a **korlátozásainak** ismerete: mivel a webkiszolgálóval azonos folyamatban fut, nem biztosít kitartást (a feladatok összeomlás/újraindítás esetén elvesznek), nincs újrapróbálkozás, nincs ütemezés, és nem alkalmas nehéz vagy kritikus munkához.

Ennek a határnak a felismerése — `BackgroundTasks` használata gyors, nem kritikus, "tüzelj és felejtsd el" feladatokhoz, és valódi feladatsor, például **Celery/ARQ** használata tartós, újrapróbálható, ütemezett vagy nehéz háttérmunkához — az a kulcsfontosságú megítélés, amely megakadályozza a BackgroundTasks-on való támaszkodás gyakori hibáját olyan munkához, amely nem veszhet el, így ez fontos praktikus tudás az megbízható alkalmazások készítéséhez.