BackgroundTasks nasıl çalışır?

Question

Accepted Answer

FastAPI'nin **`BackgroundTasks`**, yanıt döndürdükten **sonra** iş çalıştırmanızı sağlar — böylece istemci hızlı bir yanıt alırken, hafif takip işleri (e-posta gönderme, logging, temizleme) arka planda gerçekleşir. Yerleşik ve basittir, hafif görevler için.

## BackgroundTasks Kullanımı

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

`BackgroundTasks` parametresini enjekte edin ve `add_task(func, *args)` öğesini çağırın. FastAPI önce yanıtı gönderir, ardından sıralanmış görevleri çalıştırır — böylece kullanıcı e-posta için beklemeye değildir.

## Birden Fazla Görev ve Bağımlılıklarla Kullanım

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

## Kritik Sınırlama: ağır/kritik işler için DEĞILDIR

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

## Hangi Durumlarda Hangisini Kullanın

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

## Neden önemli

`BackgroundTasks`, takip işlerini yapma — hoş geldiniz e-postası gönderme, günlük yazma, hafif temizleme — yapmaktan istemciyi beklemeyen yaygın ihtiyaç için uygun yerleşik bir araçtır ve kullanıcı için yanıt sürelerini iyileştirir.

Bunu anlamak, ek altyapı gerektirmediği için bu günlük hafif durumlar için kullanışlıdır.

Ancak **en önemli nokta** onun **sınırlamalarını** bilmektir: web sunucusu ile aynı işlemde çalıştığından, kalıcılık sunmaz (görevler çökmede/yeniden başlatmada kaybolur), yeniden deneme yoktur, zamanlama yoktur ve ağır veya kritik işler için uygun değildir.

Bu sınırı tanıma — hızlı, kritik olmayan, "ateş-ve-unut" görevler için `BackgroundTasks` kullanmak ve dayanıklı, yeniden denenebilir, zamanlanmış veya ağır arka plan işleri için **Celery/ARQ** gibi gerçek bir görev kuyruğu — BackgroundTasks'e kaybedilmemesi gereken işler için güvenmeye ilişkin yaygın hatayı önleyen kilit yargıdır ve bu da güvenilir uygulamalar oluşturmak için bu önemli pratik bilgiyi yapıştırır.