Depth limit останавливает запрос friends → friends → friends до запуска resolvers, но не защищает от тысячи aliases на одном уровне или вложенных lists с большим first. Поэтому вводите его как один слой demand control, а не единственную защиту GraphQL.
Сначала измерьте реальные operations и подготовьте allowlist критичных клиентов. Случайное число может сломать нормальный экран и всё равно пропустить дорогой запрос глубины три. Enforcement включают после parse и schema validation, до execution, с понятной GraphQL error и безопасным operation fingerprint в audit.
Одинаковая depth не означает одинаковую работу
| Operation | Depth | Почему стоимость различается |
|---|---|---|
| viewer { id name } | Малая | Несколько scalar fields |
| search { id name } × aliases | Та же | Breadth умножена aliases |
| projects(first:100) { issues(first:100) } | Умеренная | List multiplier до 10 000 nodes |
| node { ...fragments } | Зависит от развёртки | Fragments скрывают selections |
| Batch из 20 queries | Каждая малая | Суммарная нагрузка одного HTTP request |
Считать нужно AST после fragments и variables policy
parse(document)
validate(schema, document)
expandFragments(document)
depth = maxSelectionDepth(document)
breadth = maxSelectionsPerLevel(document)
cost = weightedCost(document, variables, schema)
reject if depth > D or breadth > B or cost > C
execute only after demand-control checks passПсевдокод не задаёт универсальные D, B и C. Инструмент должен учитывать fragments без бесконечного повторного обхода, inline fragments, interfaces/unions и introspection policy. Variables, управляющие first/limit, нормализуются и ограничиваются до умножения стоимости.
Вес поля отражает работу resolver
- Scalar из уже загруженного объекта имеет базовую небольшую стоимость.
- List умножает стоимость дочернего selection на ограниченный page size.
- Remote call, full-text search и отчёт получают больший статический или измеренный weight.
- DataLoader уменьшает N+1, но не делает бесконечный результат бесплатным.
- Authorization выполняется независимо: дешёвый запрос не получает лишние данные.
- Timeout и cancellation ограничивают уже начатую работу, но не заменяют pre-execution анализ.
GraphQL.js рекомендует вычислять сложность после validation и до execution, а scoring адаптировать к schema. Начните с консервативной модели, затем сравнивайте score с resolver counts, DB rows и latency. Если дешёвое поле систематически стоит дорого, исправьте resolver или обновите вес — не поднимайте глобальный лимит.
Trusted documents уменьшают неопределённость
Для first-party clients сохранённые операции позволяют заранее рассчитать depth/cost и отклонять неизвестные documents. Это сильнее одного runtime limit, но требует процесса регистрации и версионирования мобильных/старых клиентов. Public API обычно сохраняет runtime demand control, quotas и rate limits даже при persisted queries.
Introspection — отдельная поверхность. Её отключение не останавливает уже известный дорогой query, а depth limit не заменяет authorization. Обрабатывайте trusted documents, introspection, access control и cost как разные механизмы с разными целями.
Rollout начинается в режиме наблюдения
- Логировать operation name/fingerprint, depth, breadth, cost и duration без variables.
- Построить распределение отдельно по client и operation.
- Разобрать верхние значения и исправить pagination/N+1.
- Назначить лимиты с запасом для проверенных операций.
- Включить предупреждение клиентам или shadow deny.
- Перевести enforcement на небольшой процент traffic.
- Проверить error rate, p95 latency и нагрузку dependencies, затем расширить.
Проверяем обходы, а не один длинный пример
deep cycle -> rejected by depth
1 level + 1000 aliases -> rejected by breadth/alias limit
nested first:100 lists -> rejected by weighted cost
20-query HTTP batch -> rejected by batch/aggregate cost
known persisted query -> allowed within client quota
cancelled request -> downstream work also cancelledПриёмка проходит, когда дорогие формы отклоняются до resolver side effects, легальные clients получают стабильную ошибку и способ уменьшить запрос, а обход через aliases, fragments и batch не снижает рассчитанную стоимость. Для настройки нужны schema SDL, набор operation fingerprints, pagination defaults/maxima, resolver latency и примеры rejected errors без tokens и variables.