Bagaimanakah BackgroundTasks berfungsi?

Question

Accepted Answer

**`BackgroundTasks`** FastAPI memungkinkan anda menjalankan pekerjaan **setelah mengembalikan respons** — jadi klien mendapat balasan cepat sementara pekerjaan ringan lanjutan (mengirim email, pencatatan, pembersihan) terjadi di latar belakang. Ia terbina dan mudah, untuk tugas-tugas ringan.

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

Masukkan parameter `BackgroundTasks` dan panggil `add_task(func, *args)`. FastAPI mengirim respons terlebih dahulu, kemudian menjalankan tugas-tugas dalam antrian — jadi pengguna tidak perlu menunggu email.

## Tugas berganda dan penggunaan dengan ketergantungan

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

## Batasan penting: ini BUKAN untuk pekerjaan berat/kritis

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

## Kapan menggunakan yang mana

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

## Mengapa ini penting

`BackgroundTasks` adalah alat bawaan yang mudah digunakan untuk kebutuhan umum melakukan pekerjaan lanjutan tanpa membuat klien menunggu — mengirim email selamat datang, menulis log, pembersihan ringan — meningkatkan waktu respons bagi pengguna.

Memahaminya bermanfaat untuk kasus-kasus ringan sehari-hari ini karena tidak memerlukan infrastruktur tambahan.

Namun **poin paling penting** adalah mengetahui **batasannya**: karena berjalan dalam proses yang sama dengan server web, ia tidak menawarkan ketahanan (tugas hilang saat mogok/mulai ulang), tidak ada percobaan ulang, tidak ada penjadwalan, dan tidak cocok untuk pekerjaan berat atau kritis.

Mengenali batas ini — menggunakan `BackgroundTasks` untuk tugas cepat, non-kritis, tembak-dan-lupakan, dan antrian tugas nyata seperti **Celery/ARQ** untuk pekerjaan latar belakang yang tahan lama, dapat dicoba ulang, terjadwal, atau berat — adalah penilaian kunci yang mencegah kesalahan umum mengandalkan BackgroundTasks untuk pekerjaan yang tidak boleh hilang, menjadikan pengetahuan praktis penting ini untuk membangun aplikasi yang andal.