Come si mette in cache un'API GraphQL?

Question

IT Interview Practice · Accepted Answer

Mettere in cache GraphQL è più difficile che con REST perché c'è un solo endpoint e le richieste sono di solito POST, quindi il caching HTTP basato su URL non funziona subito. Si esegue il caching invece su tre livelli: **client**, **transport/CDN** e **server**.

## Cache client normalizzata

Apollo Client e Relay memorizzano i risultati in una **cache normalizzata** con chiave `__typename` + `id`. Ogni oggetto viene memorizzato una sola volta; query diverse che fanno riferimento allo stesso `User:1` lo condividono, così una mutation che aggiorna un'entità aggiorna automaticamente ogni vista.

```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
```

È per questo che i campi dovrebbero restituire `id` — la cache ha bisogno di una chiave stabile per deduplicare.

## Persisted query + CDN

Le **persisted query** sostituiscono la stringa della query con un hash. Il client invia un breve hash invece di un lungo corpo POST; il server cerca la query registrata.

```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
```

Trasformare le query di lettura in GET memorizzabili in cache permette a una **CDN** di servirle all'edge e riduce i payload. Gli hint `@cacheControl` (max-age, scope) permettono al server di dichiarare TTL per campo che la CDN e la cache del server Apollo rispettano.

## Lato server

Una response cache (ad esempio quella di Apollo) con chiave query + variabili + ambito di autenticazione evita di rieseguire i resolver; DataLoader gestisce la de-duplicazione per richiesta (una questione diversa — non è una cache tra richieste).

## Perché è importante

Il design a endpoint singolo con POST rompe il caching HTTP ingenuo, quindi gli intervistatori vogliono sentire la risposta **a livelli**: cache di entità normalizzata sul client, persisted query + `@cacheControl` per sbloccare il caching su CDN/edge, e dove si colloca DataLoader (per richiesta, non tra richieste).

Cache client normalizzata

Persisted query + CDN

Lato server

Perché è importante

Domande correlate