Como você faz cache de uma API GraphQL?

Question

IT Interview Practice · Accepted Answer

Fazer cache de GraphQL é mais difícil que de REST porque há um único endpoint e as requisições costumam ser POST, então o cache HTTP baseado em URL não funciona de imediato. Em vez disso, você faz cache em três camadas: **cliente**, **transporte/CDN** e **servidor**.

## Cache normalizado no cliente

O Apollo Client e o Relay armazenam os resultados em um **cache normalizado** com chave em `__typename` + `id`. Cada objeto é guardado uma vez; consultas diferentes que referenciam o mesmo `User:1` o compartilham, então uma mutation que atualiza uma entidade atualiza todas as visões automaticamente.

```graphql
# Both queries write to the same normalized entry User:1 in the client cache
query A { user(id: "1") { id name } }
query B { post(id: "9") { author { id name } } }  # author is also User:1
```

É por isso que os campos devem retornar `id` — o cache precisa de uma chave estável para deduplicar.

## Persisted queries + CDN

As **persisted queries** substituem a string da consulta por um hash. O cliente envia um hash curto em vez de um corpo POST longo; o servidor procura a consulta registrada.

```js
// Automatic Persisted Queries: first a tiny GET with just the hash
// GET /graphql?extensions={"persistedQuery":{"sha256Hash":"abc..."}}
// -> because it's a GET with a stable key, a CDN can cache the RESPONSE at the edge
```

Transformar consultas de leitura em GETs cacheáveis permite que uma **CDN** as sirva na borda e reduz o tamanho dos payloads. Os hints `@cacheControl` (max-age, scope) permitem que o servidor declare TTLs por campo que a CDN e o cache do Apollo server respeitam.

## Lado do servidor

Um response cache (por exemplo, o do Apollo) com chave em consulta + variáveis + escopo de autenticação evita reexecutar os resolvers; o DataLoader trata da deduplicação por requisição (uma preocupação diferente — não é um cache entre requisições).

## Por que isso importa

O design de endpoint único/POST quebra o cache HTTP ingênuo, então os entrevistadores querem ouvir a resposta **em camadas**: cache normalizado de entidades no cliente, persisted queries + `@cacheControl` para destravar o cache de CDN/borda, e onde o DataLoader se encaixa (por requisição, não entre requisições).

Cache normalizado no cliente

Persisted queries + CDN

Lado do servidor

Por que isso importa

Perguntas relacionadas