Jak działają BackgroundTasks?

Question

Accepted Answer

**`BackgroundTasks`** FastAPI pozwala uruchamiać pracę **po zwróceniu odpowiedzi** — klient otrzymuje szybką odpowiedź, a lekkie prace następcze (wysyłanie wiadomości e-mail, logowanie, czyszczenie) odbywają się w tle. Jest wbudowany i prosty, do lekkich zadań.

## Używanie 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
```

Wstrzyknij parametr `BackgroundTasks` i wywołaj `add_task(func, *args)`. FastAPI najpierw wysyła odpowiedź, a następnie uruchamia zadania w kolejce — więc użytkownik nie czeka na wiadomość e-mail.

## Wiele zadań i użycie z zależnościami

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

## Kluczowe ograniczenie: to NIE jest dla pracy ciężkiej/krytycznej

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

## Kiedy używać czego

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

## Dlaczego to ważne

`BackgroundTasks` to wygodne wbudowane narzędzie do powszechnej potrzeby wykonywania prac następczych bez zmuszania klienta do czekania — wysyłanie powitalnej wiadomości e-mail, pisanie dziennika, lekkie czyszczenie — poprawiające czasy odpowiedzi dla użytkownika.

Zrozumienie tego jest przydatne dla tych codziennych lekkich przypadków, ponieważ nie wymaga dodatkowej infrastruktury.

Ale **najważniejszy punkt** to poznanie **jego ograniczeń**: ponieważ działa w tym samym procesie co serwer sieciowy, nie oferuje trwałości (zadania są tracone przy awarii/ponownym uruchomieniu), brak ponownych prób, brak planowania i nie jest odpowiedni dla pracy ciężkiej lub krytycznej.

Znajomość tego warunku — używanie `BackgroundTasks` do szybkich, niekrytycznych, wyzwalanych zadań, a rzeczywistej kolejki zadań, takiej jak **Celery/ARQ** dla trwałych, podlegających ponownym próbom, zaplanowanych lub ciężkich zadań w tle — jest kluczową osądem, które zapobiega częstemu błędowi polegania na BackgroundTasks do pracy, która nie powinna zostać utracona, czyniąc to ważną praktyczną wiedzą do budowania niezawodnych aplikacji.