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 не означает одинаковую работу

OperationDepthПочему стоимость различается
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 начинается в режиме наблюдения

  1. Логировать operation name/fingerprint, depth, breadth, cost и duration без variables.
  2. Построить распределение отдельно по client и operation.
  3. Разобрать верхние значения и исправить pagination/N+1.
  4. Назначить лимиты с запасом для проверенных операций.
  5. Включить предупреждение клиентам или shadow deny.
  6. Перевести enforcement на небольшой процент traffic.
  7. Проверить 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.

Проверенные источники