Какие плюсы и минусы использования класс Depends в FastAPI?

# Depends в FastAPI: плюсы и минусы

Что такое Depends

Depends — это встроенный механизм FastAPI для управления зависимостями. Он позволяет инъектировать зависимости в обработчики запросов, middleware и другие компоненты через аргументы функции.

from fastapi import Depends, FastAPI

app = FastAPI()

def get_current_user(token: str) -> str:
    # Логика получения пользователя из токена
    return 'user_from_token'

@app.get('/protected')
async def protected_route(user: str = Depends(get_current_user)):
    return {'user': user}

ПЛЮСЫ Depends

1. Инверсия управления (IoC)

Зависимости передаются в функцию, а не создаются внутри неё. Это упрощает тестирование и делает код более модульным.

2. Переиспользование логики

Одну зависимость можно применить ко многим маршрутам. Если изменить логику, обновляется везде автоматически:

def verify_token(token: str = Header()) -> str:
    if not token.startswith('Bearer '):
        raise HTTPException(status_code=401)
    return token

@app.get('/posts')
async def get_posts(token: str = Depends(verify_token)):
    return {'posts': []}

@app.get('/users')
async def get_users(token: str = Depends(verify_token)):
    return {'users': []}

3. Автоматическая валидация и документация

FastAPI автоматически генерирует Swagger документацию для всех зависимостей, включая их параметры.

4. Сложные цепочки зависимостей

Зависимости могут зависеть от других зависимостей. FastAPI сам разрешит граф зависимостей:

def get_db() -> Database:
    return Database()

def get_user_service(db: Database = Depends(get_db)) -> UserService:
    return UserService(db)

@app.get('/user')
async def get_user(service: UserService = Depends(get_user_service)):
    return service.get_user()

5. Кэширование результатов

Внутри одного запроса одинаковые зависимости вычисляются один раз:

def get_db() -> Database:
    print('DB created')
    return Database()

@app.get('/data')
async def get_data(db1: Database = Depends(get_db), db2: Database = Depends(get_db)):
    # 'DB created' выведется только один раз
    return {'ok': True}

МИНУСЫ Depends

1. Неявный граф зависимостей

Сложно отследить, откуда берутся данные. При изменении зависимостей может нарушиться вся цепочка. Требуется хорошее тестирование и документирование.

2. Производительность при большом графе

Eсли у вас 10+ уровней вложенных зависимостей, FastAPI потратит время на их разрешение. В критичных местах нужен профайлинг:

import time

def slow_dependency():
    time.sleep(0.1)
    return 'value'

# На каждый запрос потратится минимум 0.1 сек
@app.get('/endpoint')
async def endpoint(val: str = Depends(slow_dependency)):
    return {'val': val}

3. Отладка может быть сложной

Ошибка в глубокой зависимости даёт стек вызовов, где не сразу понятна цепочка:

# Ошибка будет в get_db, но её вызвала цепочка: endpoint → service → db

4. Тестирование требует моков

Чтобы протестировать маршрут, нужно замокировать все его зависимости:

from unittest.mock import Mock

async def test_endpoint():
    mock_db = Mock()
    app.dependency_overrides[get_db] = lambda: mock_db
    # Тест
    app.dependency_overrides.clear()

5. Не подходит для всех сценариев

Если логика очень специфична для одного маршрута, обязательный Depends добавляет сложность:

# Излишне для маршрута, который никогда не переиспользуется
@app.get('/unique')
async def unique_route(
    param: str = Depends(lambda: get_something())
):
    return param

Когда использовать Depends

✅ Используй Depends:

• Для аутентификации и авторизации
• Для работы с БД (сессии, transactions)
• Для логирования и мониторинга
• Когда логика переиспользуется в нескольких маршрутах
• Для валидации и трансформации данных

❌ Избегай Depends:

• Для сложной бизнес-логики (лучше в сервисах)
• Когда зависимость нужна только одному маршруту
• Для асинхронных операций с высокой задержкой (без кэширования)

Вывод

Depends — мощный инструмент для написания чистого, поддерживаемого кода в FastAPI. Он упрощает инъекцию зависимостей и делает код более модульным. Однако требует аккуратного проектирования графа зависимостей и хорошего понимания того, как он работает. Используй его для инфраструктурных зависимостей (БД, аутентификация), но не переусложняй с его помощью бизнес-логику.