Come funzionano i BackgroundTasks?

Question

IT Interview Practice · 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.

Utilizzare BackgroundTasks

Compiti multipli e uso con dipendenze

La limitazione cruciale: NON è per lavoro pesante/critico

Quando usare quale

Perché è importante

Domande correlate