Miten GraphQL-API cachetetaan?

Question

IT Interview Practice · Accepted Answer

GraphQL:n cachettaminen on vaikeampaa kuin RESTin, koska on vain yksi endpoint ja pyynnöt ovat yleensä POST-pyyntöjä, joten URL-pohjainen HTTP-caching ei toimi suoraan. Sen sijaan cachettaa kolmella tasolla: **client**, **transport/CDN** ja **palvelin**.

## Normalisoitu client-cache

Apollo Client ja Relay tallentavat tulokset **normalisoituun cacheen**, jonka avaimena on `__typename` + `id`. Jokainen objekti tallennetaan kerran; eri kyselyt, jotka viittaavat samaan `User:1`:een, jakavat sen, joten mutation, joka päivittää yhden entiteetin, päivittää kaikki näkymät automaattisesti.

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

Tästä syystä kenttien tulisi palauttaa `id` — cache tarvitsee vakaan avaimen deduplikointiin.

## Persisted queries + CDN

**Persisted queryt** korvaavat kyselymerkkijonon hashilla. Client lähettää lyhyen hashin pitkän POST-rungon sijaan; palvelin hakee rekisteröidyn kyselyn.

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

Lukukyselyjen muuttaminen cachettaviksi GET-pyynnöiksi antaa **CDN**:n tarjoilla ne edgessä ja pienentää payloadeja. `@cacheControl`-vihjeet (max-age, scope) antavat palvelimen ilmoittaa kenttäkohtaiset TTL:t, joita CDN ja Apollo-palvelincache noudattavat.

## Palvelinpuoli

Vastauscache (esim. Apollon), jonka avaimena on kysely + muuttujat + auth-scope, välttää resolverien uudelleensuorittamisen; DataLoader hoitaa pyyntökohtaisen deduplikoinnin (eri asia — se ei ole pyyntöjen välinen cache).

## Miksi se on tärkeää

Yhden endpointin/POSTin suunnittelu rikkoo naiivin HTTP-cachingin, joten haastattelijat haluavat kuulla **kerroksellisen** vastauksen: normalisoitu entiteetticache clientillä, persisted queryt + `@cacheControl` avaamaan CDN-/edge-cachingin, ja missä DataLoader sopii kuvaan (pyyntökohtainen, ei pyyntöjen välinen).

Normalisoitu client-cache

Persisted queries + CDN

Palvelinpuoli

Miksi se on tärkeää

Aiheeseen liittyvät kysymykset