BackgroundTasks hoạt động như thế nào?

Question

Accepted Answer

**`BackgroundTasks`** của FastAPI cho phép bạn chạy công việc **sau khi trả về response** — nên client nhận được phản hồi nhanh trong khi công việc tiếp theo nhẹ nhàng (gửi email, logging, dọn dẹp) diễn ra ở background. Nó tích hợp sẵn và đơn giản, dành cho các tác vụ nhẹ.

## Dùng BackgroundTasks

```python
from fastapi import BackgroundTasks

def send_email(address: str, message: str):
    # công việc hơi chậm mà client không nên chờ
    email_client.send(address, message)

@app.post("/signup")
def signup(user: User, background_tasks: BackgroundTasks):   # tiêm BackgroundTasks
    save_user(user)
    background_tasks.add_task(send_email, user.email, "Welcome!")   # đưa vào hàng đợi
    return {"message": "User created"}    # RESPONSE trả về NGAY; email gửi SAU
```

Tiêm một tham số `BackgroundTasks` và gọi `add_task(func, *args)`. FastAPI gửi response trước, rồi chạy (các) tác vụ đã đưa vào hàng đợi — nên người dùng không bị bắt chờ email.

## Nhiều tác vụ và dùng với dependency

```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)     # nhiều tác vụ chạy theo thứ tự, sau response
    return {"status": "created"}
```

## Giới hạn then chốt: KHÔNG dành cho công việc nặng/quan trọng

```text
BackgroundTasks chạy TRONG CÙNG TIẾN TRÌNH với web server:
  ✗ KHÔNG có tính bền vững — nếu server crash/restart, tác vụ trong hàng đợi MẤT
  ✗ KHÔNG retry, lập lịch, hay phân tán
  ✗ Công việc CPU nặng vẫn sẽ chiếm dụng tiến trình worker
→ Tốt cho: tác vụ nhanh, không quan trọng, fire-and-forget (email, logging, dọn dẹp nhẹ)
→ Cho job nặng, quan trọng, cần retry, hoặc lập lịch → dùng Celery / ARQ (một task queue thực sự)
```

## Khi nào dùng cái nào

```text
BackgroundTasks → công việc đơn giản, nhẹ, best-effort gắn với một request (không hạ tầng thêm)
Celery / ARQ    → job bền vững, cần retry, lập lịch, phân tán (cần broker/worker)
```

## Tại sao điều này quan trọng

`BackgroundTasks` là một công cụ tích hợp tiện lợi cho nhu cầu phổ biến là làm công việc tiếp theo mà không bắt client chờ — gửi email chào mừng, ghi log, dọn dẹp nhẹ — cải thiện thời gian phản hồi cho người dùng.

Hiểu nó hữu ích cho các trường hợp nhẹ hằng ngày này vì nó không cần hạ tầng thêm.

Nhưng **điểm quan trọng nhất** là biết **giới hạn** của nó: vì nó chạy trong cùng tiến trình với web server, nó không có tính bền vững (tác vụ mất khi crash/restart), không retry, không lập lịch, và không phù hợp cho công việc nặng hoặc quan trọng.

Nhận ra ranh giới này — dùng `BackgroundTasks` cho tác vụ nhanh, không quan trọng, fire-and-forget, và một task queue thực sự như **Celery/ARQ** cho job background bền vững, cần retry, lập lịch, hoặc nặng — là phán đoán then chốt ngăn sai lầm phổ biến là dựa vào BackgroundTasks cho công việc không được phép mất, biến đây thành kiến thức thực tiễn quan trọng để xây dựng ứng dụng đáng tin cậy.