Как работает внедрение зависимостей (Depends)?

Question

Accepted Answer

Система **внедрения зависимостей** FastAPI позволяет объявлять переиспользуемые зависимости (функции/классы), которые FastAPI вызывает и **внедряет** в ваши операции пути через `Depends()`. Она используется для общей логики, такой как сессии базы данных, аутентификация и общие параметры — сохраняя код DRY и тестируемым.

## Базовая зависимость

```python
from fastapi import Depends

# a dependency is just a callable that returns something
def pagination(skip: int = 0, limit: int = 10):
    return {"skip": skip, "limit": limit}

@app.get("/items")
def list_items(params: dict = Depends(pagination)):   # FastAPI calls pagination() and injects the result
    return params
# the skip/limit query params are now handled by the reusable dependency
```

Объявление `params = Depends(pagination)` говорит FastAPI вызвать `pagination` (разрешая *её* параметры из запроса тоже) и передать результат в вашу функцию. Зависимость переиспользуется во многих endpoints.

## Зависимости с очисткой (yield) — например, сессии базы данных

```python
def get_db():
    db = SessionLocal()
    try:
        yield db                  # provide the session to the endpoint
    finally:
        db.close()                # cleanup runs AFTER the response — guaranteed

@app.get("/users")
def list_users(db = Depends(get_db)):
    return db.query(User).all()    # uses the injected, auto-closed session
```

Зависимость с `yield` предоставляет ресурс и запускает очистку после запроса — стандартный паттерн для сессий базы данных (открыть перед, закрыть после, автоматически).

## Зависимости могут зависеть от зависимостей

```python
def get_current_user(token: str = Depends(get_token)):   # depends on another dependency
    return decode(token)

@app.get("/me")
def me(user: User = Depends(get_current_user)):           # auth via injection
    return user
```

Зависимости образуют дерево — FastAPI разрешает всю цепь. Это то, как типично реализуется аутентификация (зависимость `get_current_user`).

## Зависимости классов и переиспользование

```python
@app.get("/items", dependencies=[Depends(verify_api_key)])   # run a dependency without using its return
def items(): ...                                              # e.g. enforce auth as a side effect
```

## Почему это важно

Внедрение зависимостей — одна из самых мощных и важных функций FastAPI — это то, как вы делитесь и переиспользуете логику чисто в endpoints (сессии базы данных, аутентификация, общие параметры запроса, проверки прав) без дублирования.

Понимание этого необходимо, потому что оно лежит в основе основных паттернов: **зависимость с `yield`** — стандартный способ управления сессиями базы данных (с гарантированной очисткой после каждого запроса), а **зависимость `get_current_user`** — идиоматичный способ реализации аутентификации.

Внедрение зависимостей также делает код очень **тестируемым** — вы можете переопределять зависимости моками в тестах.

Элегантность системы (зависимости разрешают свои собственные параметры из запроса, могут зависеть от других зависимостей, образуя дерево, и интегрируются с документацией) делает её универсальным инструментом для структурирования реальных приложений, поэтому овладение `Depends` — ключ к созданию хорошо организованных, поддерживаемых, тестируемых FastAPI приложений.