SeniorПроизводительностьИногдаЕщё не отвечали

Во что обходится `response_model` на горячем списочном эндпоинте с 5000 строк?

Каждая строка валидируется и сериализуется повторно: объекты ORM уже собраны, а модель пересобирает их по полям до записи JSON. На больших списках этот проход и определяет время запроса. Сузьте модель, разбейте выдачу на страницы или верните объект ответа напрямую, минуя модель.

✗Считать response_model разовой ценой при старте, а не ценой на каждую строку
✗Менять кодировщик JSON на более быстрый, оставив второй проход валидации на месте
✗Отдавать неограниченные списки и трактовать результат как проблему сериализации

→Как доказать, что запрос определяет проход валидации, а не обращение к базе?
→Чем вы жертвуете, возвращая объект ответа напрямую?

Оглавление

Задача

Списочный эндпоинт отдаёт 5000 строк и держится на десятках миллисекунд запроса к базе, но отвечает сотнями. Куда уходит время и что с этим делать.

Разбор

Python

class UserOut(BaseModel):
    id: int
    email: str
    display_name: str


@app.get("/users", response_model=list[UserOut])
def list_users(session: SessionDep) -> list[User]:
    return session.query(User).all()   # 5000 объектов ORM уже собраны

Строки проходят сборку дважды. Сначала драйвер и ORM превращают ответ базы в 5000 объектов User. Затем response_model берёт каждый объект, читает объявленные поля, проверяет типы и собирает из них новый экземпляр UserOut — и только после этого пишется JSON. Второй проход линеен по числу строк и по числу полей, поэтому на больших выдачах он и становится основным слагаемым, а не запрос к базе.

⚠️ Быстрый кодировщик JSON здесь не помогает: он ускоряет последний шаг, а не проход валидации перед ним.

Решение

Python

# 1. Не тянуть лишние поля — сужаем и запрос, и модель
rows = session.query(User.id, User.email, User.display_name).all()

# 2. Ограничить выдачу — страница вместо всей таблицы
rows = rows[offset : offset + limit]

# 3. Горячий путь, где форма ответа уже гарантирована — мимо модели
return ORJSONResponse([{"id": r.id, "email": r.email} for r in rows])

Ключевые моменты