Как работают 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` — это удобный встроенный инструмент для типичной необходимости выполнения дополнительной работы без задержки клиента — отправка приветственного письма, запись в журнал, легкая очистка — улучшая время отклика для пользователя.

Понимание этого полезно для таких повседневных легких случаев, так как не требует дополнительной инфраструктуры.

Но **самый важный момент** — понимание его **ограничений**: поскольку он работает в том же процессе, что и веб-сервер, он не обеспечивает сохраняемость (задачи теряются при сбое/перезагрузке), нет повторных попыток, нет планирования и не подходит для тяжелой или критической работы.

Признание этой границы — использование `BackgroundTasks` для быстрых, некритических задач типа «выстрелил и забыл», а реальной очереди задач, такой как **Celery/ARQ**, для надежных, повторяемых, запланированных или тяжелых фоновых работ — это ключевое суждение, которое предотвращает распространенную ошибку полагаться на BackgroundTasks для работ, которые нельзя потерять, что делает эту практическую информацию важной для построения надежных приложений.