Kaip veikia BackgroundTasks?

Question

Accepted Answer

FastAPI **`BackgroundTasks`** leidžia vykdyti darbą **po atsako grąžinimo** — todėl klientas gauna greitą atsaką, o lengvi sekantys darbai (el. pašto siuntimas, registravimas, valymas) vykdomi fone. Jis yra integruotas ir paprastas lengviems uždaviniams.

## BackgroundTasks naudojimas

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

Infekuokite `BackgroundTasks` parametrą ir skambinkite `add_task(func, *args)`. FastAPI pirmiausia siunčia atsaką, tada vykdo eilėje stovinčius uždavinius — todėl vartotojas nenegaudžia el. pašto laukimo.

## Keli uždaviniai ir naudojimas su priklausomybėmis

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

## Kritinis apribojimas: tai ne sunkiam/kritiniam darbui

```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 naudoti ką

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

## Kodėl tai svarbu

`BackgroundTasks` yra patogus integruotas įrankis dažnam poreikiui — atlikti sekantį darbą nedarant kliento laukti — siųsti sveikatus el. laiškus, rašyti žurnalą, lengvą valymą — pagerinant atsakų laikus vartotojui.

Jo supratimas naudingas šiais kasdieniais lengvais atvejais, nes nereikalinga papildoma infrastruktūra.

Bet **svarbiausias punktas** yra žinoti jo **apribojimus**: nes jis veikia tame pačiame procese kaip žiniatinklio serveris, jis neteikia nuolatinumo (uždaviniai prarandami perkrovus/perstartuojant), nėra pakartotinių bandymų, nėra planavimo ir netinka sunkiam ar kritiniam darbui.

Šios ribos pripažinimas — `BackgroundTasks` naudoti greitiems, nekritiniams, "paleisti ir pamiršti" uždaviniams, o tikrą užduočių eilę, pvz., **Celery/ARQ**, naudoti ilgiamam, pakartojamam, planuojamam ar sunkiam foniniam darbui — yra esminis sprendimas, kuris nustato bendrą klaidą dėl `BackgroundTasks` pasitikėjimo darbui, kuris neturi būti prarastas, todėl šios praktinės žinios yra svarbi kuriant patikimas programas.