Kako rade BackgroundTasks?

Question

Accepted Answer

FastAPI-jeve **`BackgroundTasks`** omogućuju vam pokretanje posla **nakon vraćanja odgovora** — tako da klijent dobiva brz odgovor dok se laganije pratnje zadaće (slanje e-maila, logiranje, čišćenje) izvršavaju u pozadini. Ugrađeno je i jednostavno, za lagane zadaće.

## Korištenje 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
```

Ubacite `BackgroundTasks` parametar i pozovite `add_task(func, *args)`. FastAPI prvo pošalje odgovor, zatim pokreće redu čekanja — tako da korisnik ne čeka e-mail.

## Više zadataka i korištenje s ovisnostima

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

## Kritična ograničenja: nije za teške/kritične zadaće

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

## Kada koristiti koju

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

## Zašto je to važno

`BackgroundTasks` je prikladan ugrađeni alat za česte potrebe — slanje pozdravnog e-maila, pisanje dnevnika, lakše čišćenje — poboljšavanje vremena odgovora korisnikova.

Razumijevanje je korisno za te svakodnevne lagane slučajeve jer ne zahtijeva dodatnu infrastrukturu.

Ali **najvažnije** je znati njegova **ograničenja**: jer se izvršava u istom procesu kao web server, ne nudi trajnost (zadaci se gube pri rušenju/ponovnom pokretanju), nema pokušaja, nema rasporeda i nije prikladno za teške ili kritične poslove.

Prepoznavanje ove granice — korištenje `BackgroundTasks` za brze, nekritične, "pali-i-zaboravi" zadaće, i stvarnog redoslijeda zadataka kao što je **Celery/ARQ** za trajne, ponovljive, zakazane ili teške poslove — je ključna prosudba koja sprječava čest problem oslanjanja na BackgroundTasks za posao koji se ne smije izgubiti, što čini ovo važnom praktičnom znanjem za izgradnju pouzdanih aplikacija.