Как кэшировать GraphQL API?

Question

IT Interview Practice · Accepted Answer

Кэшировать GraphQL сложнее, чем REST, потому что конечная точка одна, а запросы обычно POST, поэтому HTTP-кэширование на основе URL из коробки не работает. Вместо этого вы кэшируете на трёх слоях: **клиент**, **транспорт/CDN** и **сервер**.

## Нормализованный клиентский кэш

Apollo Client и Relay хранят результаты в **нормализованном кэше** с ключом `__typename` + `id`. Каждый объект хранится один раз; разные запросы, ссылающиеся на один и тот же `User:1`, разделяют его, поэтому мутация, обновляющая одну сущность, автоматически обновляет все представления.

```graphql
# Оба запроса пишут в одну нормализованную запись User:1 в клиентском кэше
query A { user(id: "1") { id name } }
query B { post(id: "9") { author { id name } } }  # author — это тоже User:1
```

Именно поэтому поля должны возвращать `id` — кэшу нужен стабильный ключ для дедупликации.

## Persisted queries + CDN

**Persisted queries** заменяют строку запроса хешем. Клиент отправляет короткий хеш вместо длинного POST-тела; сервер ищет зарегистрированный запрос.

```js
// Automatic Persisted Queries: сначала крошечный GET только с хешем
// GET /graphql?extensions={"persistedQuery":{"sha256Hash":"abc..."}}
// -> поскольку это GET со стабильным ключом, CDN может кэшировать ОТВЕТ на краю сети
```

Превращение запросов на чтение в кэшируемые GET позволяет **CDN** отдавать их на краю сети и уменьшает объём данных. Подсказки `@cacheControl` (max-age, scope) позволяют серверу объявлять TTL для каждого поля, которые соблюдают CDN и серверный кэш Apollo.

## На стороне сервера

Кэш ответов (например, у Apollo) с ключом запрос + переменные + область авторизации избавляет от повторного запуска resolvers; DataLoader обрабатывает дедупликацию в рамках запроса (другая задача — это не межзапросный кэш).

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

Дизайн с единственной конечной точкой/POST ломает наивное HTTP-кэширование, поэтому интервьюеры хотят услышать **послойный** ответ: нормализованный кэш сущностей на клиенте, persisted queries + `@cacheControl` для разблокировки CDN/edge-кэширования и где место DataLoader (в рамках запроса, а не между запросами).

Нормализованный клиентский кэш

Persisted queries + CDN

На стороне сервера

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

Похожие вопросы