BackgroundTasks ทำงานอย่างไร

Question

Accepted Answer

**`BackgroundTasks`** ของ FastAPI ให้คุณสามารถเรียกใช้งาน **หลังจากส่งคำตอบกลับ** — เพื่อให้ไคลเอนต์ได้รับการตอบสนองที่รวดเร็ว ในขณะที่งานติดตามแบบเบา (ส่งอีเมล การบันทึก การทำความสะอาด) ทำงานในพื้นหลัง นั่นเป็นตัวเลือกที่มีให้ในตัวและเรียบง่ายสำหรับงานที่มีน้ำหนักเบา

## การใช้ 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
```

ใส่พารามิเตอร์ `BackgroundTasks` และเรียก `add_task(func, *args)` FastAPI ส่งการตอบสนองก่อน จากนั้นจึงเรียกใช้งานที่อยู่ในคิว — ดังนั้นผู้ใช้จึงไม่ต้องรอสำหรับอีเมล

## งานหลายรายการและการใช้กับการพึ่งพา

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

## ข้อ จำกัด ที่สำคัญ: มันไม่ใช่สำหรับการทำงานที่หนักหรือสำคัญ

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

## ตัดสินใจว่าจะใช้อะไร

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

## ทำไมจึงมีความสำคัญ

`BackgroundTasks` เป็นเครื่องมือในตัวที่สะดวกสำหรับความต้องการทั่วไป ในการทำงานติดตามโดยไม่ให้ไคลเอนต์รอคอย — ส่งอีเมลยินดีต้อนรับ เขียนลอจ การทำความสะอาดเบา — เพื่อปรับปรุงเวลาการตอบสนองสำหรับผู้ใช้

การทำความเข้าใจนี้มีประโยชน์สำหรับกรณีเบาๆ ในชีวิตประจำวันเหล่านี้ เนื่องจากไม่ต้องใช้โครงสร้างพื้นฐานเพิ่มเติม

แต่ **จุดที่สำคัญที่สุด** คือการรู้ **ข้อจำกัด** ของมัน: เนื่องจากมันทำงานในกระบวนการเดียวกันกับเซิร์ฟเวอร์ web จึงไม่มีการอยู่ (งานสูญหายเมื่อ crash/restart) ไม่มีการลองใหม่ ไม่มีการกำหนดตารางเวลา และไม่เหมาะสำหรับงานที่หนักหรือสำคัญ

การตระหนักรู้เส้นแบ่งนี้ — การใช้ `BackgroundTasks` สำหรับงานเร็วๆ ที่ไม่สำคัญ "ยิงแล้วลืม" และคิวงานที่แท้จริงเช่น **Celery/ARQ** สำหรับงานพื้นหลังที่คงอยู่ สามารถลองใหม่ได้ มีการกำหนดตารางเวลา หรือหนัก — คือการตัดสินใจหลักที่ป้องกันข้อผิดพลาดทั่วไปของการพึ่งพา BackgroundTasks สำหรับงานที่ไม่ควรสูญหาย ทำให้นี่เป็นความรู้เชิงปฏิบัติที่สำคัญสำหรับการสร้างแอปพลิเคชันที่เชื่อถือได้