Come funzionano i BackgroundTasks?

Question

Accepted Answer

**`BackgroundTasks`** di FastAPI ti permette di eseguire lavoro **dopo aver restituito la risposta** — quindi il client riceve una risposta veloce mentre il lavoro leggero di follow-up (invio email, logging, cleanup) avviene in background. È incorporato e semplice, per attività leggere.

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

Injetta un parametro `BackgroundTasks` e chiama `add_task(func, *args)`. FastAPI invia la risposta per primo, poi esegue il/i task in coda — così l'utente non rimane in attesa dell'email.

## Compiti multipli e uso con dipendenze

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

## La limitazione cruciale: NON è per lavoro pesante/critico

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

## Quando usare quale

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

## Perché è importante

`BackgroundTasks` è uno strumento built-in conveniente per l'esigenza comune di eseguire lavoro di follow-up senza far aspettare il client — invio email di benvenuto, scrittura di log, cleanup leggero — migliorando i tempi di risposta per l'utente.

Comprenderlo è utile per questi casi leggeri quotidiani poiché non richiede infrastruttura aggiuntiva.

Ma il **punto più importante** è conoscere le sue **limitazioni**: poiché viene eseguito nello stesso processo del web server, non offre persistenza (i task vengono persi in caso di crash/restart), nessun retry, nessuna pianificazione, e non è adatto a lavoro pesante o critico.

Riconoscere questo confine — utilizzando `BackgroundTasks` per task rapidi, non critici, fire-and-forget, e una vera task queue come **Celery/ARQ** per lavori di background durevoli, ritentabili, pianificati o pesanti — è il giudizio chiave che previene l'errore comune di fare affidamento su BackgroundTasks per lavoro che non deve essere perso, rendendo questa conoscenza pratica importante per costruire applicazioni affidabili.