Hogyan cache-elsz egy GraphQL API-t?

Question

IT Interview Practice · Accepted Answer

A GraphQL cache-elése nehezebb, mint a REST-é, mert egyetlen endpoint van, a kérések pedig általában POST-ok, így az URL-alapú HTTP caching alapból nem működik. Ehelyett három rétegen cache-elsz: **kliens**, **transport/CDN** és **szerver**.

## Normalizált kliens cache

Az Apollo Client és a Relay az eredményeket **normalizált cache**-ben tárolja, `__typename` + `id` kulcs alapján. Minden object egyszer tárolódik; a különböző lekérdezések, amelyek ugyanarra a `User:1`-re hivatkoznak, megosztják, így egy mutation, amely egy entitást frissít, automatikusan frissít minden nézetet.

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

Ezért kell a mezőknek `id`-t visszaadniuk — a cache-nek stabil kulcsra van szüksége a deduplikációhoz.

## Persisted query-k + CDN

A **persisted query-k** a lekérdezés stringjét egy hashre cserélik. A kliens egy hosszú POST törzs helyett egy rövid hasht küld; a szerver kikeresi a regisztrált lekérdezést.

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

Ha az olvasó lekérdezéseket cache-elhető GET-ekké alakítod, akkor egy **CDN** az edge-en szolgálhatja ki őket, ráadásul a payloadok is kisebbek lesznek. A `@cacheControl` hintek (max-age, scope) lehetővé teszik, hogy a szerver mezőnkénti TTL-eket deklaráljon, amelyeket a CDN és az Apollo szerver cache tiszteletben tart.

## Szerveroldal

Egy válasz-cache (pl. az Apollóé), amelyet a lekérdezés + változók + auth scope kulcsol, elkerüli a resolverek újrafuttatását; a DataLoader a kérésen belüli deduplikációt kezeli (ez egy másik dolog — nem kérések közötti cache).

## Miért fontos

Az egy endpoint / POST kialakítás elrontja a naiv HTTP cachinget, ezért az interjúztatók a **rétegzett** választ szeretnék hallani: normalizált entitás-cache a kliensen, persisted query-k + `@cacheControl` a CDN/edge caching feloldásához, és hogy a DataLoader hova illik (kérés-szintre, nem kérések közé).

Normalizált kliens cache

Persisted query-k + CDN

Szerveroldal

Miért fontos

Kapcsolódó kérdések