Cum funcționează BackgroundTasks?

Question

Accepted Answer

**`BackgroundTasks`** lui FastAPI îți permite să rulezi muncă **după ce returnezi răspunsul** — deci clientul primește un răspuns rapid în timp ce munca de urmărire ușoară (trimitere de e-mail, logging, curățenie) se întâmplă în fundal. Este încorporat și simplu, pentru sarcini ușoare.

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

Injectează un parametru `BackgroundTasks` și apelează `add_task(func, *args)`. FastAPI trimite mai întâi răspunsul, apoi execută sarcinile în coadă — deci utilizatorul nu așteptă pentru e-mail.

## Sarcinile multiple și utilizare cu dependențe

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

## Limitarea crucială: NU este pentru munca grea/critică

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

## Când să folosești ce

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

## De ce este important

`BackgroundTasks` este un instrument încorporat convenabil pentru necesitatea comună de a efectua munca de urmărire fără a face clientul să aștepte — trimitere de e-mail de bun venit, scriere în jurnal, curățenie ușoară — îmbunătățind timpii de răspuns pentru utilizator.

Înțelegerea acestuia este utilă pentru aceste cazuri ușoare din viața de zi cu zi, deoarece nu necesită infrastructură suplimentară.

Dar **punctul cel mai important** este cunoașterea **limitărilor sale**: deoarece se execută în același proces ca serverul web, nu oferă persistență (sarcinile se pierd la căderi/reporniri), fără încercări repetate, fără programare, și nu este potrivit pentru munca grea sau critică.

Recunoașterea acestei limite — utilizarea `BackgroundTasks` pentru sarcini rapide, necritice, fire-and-forget, și o coadă de sarcini reală cum ar fi **Celery/ARQ** pentru joburi de fundal durabile, reîncercabile, programate sau grele — este judecata-cheie care previne greșeala comună de a se baza pe BackgroundTasks pentru munca care nu trebuie pierdută, făcând aceasta cunoștință practică importantă pentru construirea aplicațiilor fiabile.