Kaip kešuoti GraphQL API?

Question

IT Interview Practice · Accepted Answer

GraphQL kešavimas sudėtingesnis nei REST, nes yra vienas endpoint, o užklausos paprastai yra POST, todėl URL pagrindu veikiantis HTTP caching iš karto neveikia. Vietoj to kešuojate trijuose sluoksniuose: **kliento**, **transporto/CDN** ir **serverio**.

## Normalizuotas kliento cache

Apollo Client ir Relay saugo rezultatus **normalizuotame cache**, raktuojamame pagal `__typename` + `id`. Kiekvienas objektas saugomas vieną kartą; skirtingos užklausos, nurodančios tą patį `User:1`, jį dalijasi, todėl mutacija, atnaujinanti vieną esybę, automatiškai atnaujina visus vaizdus.

```graphql
# Abi užklausos rašo į tą patį normalizuotą įrašą User:1 kliento cache
query A { user(id: "1") { id name } }
query B { post(id: "9") { author { id name } } }  # author taip pat yra User:1
```

Būtent todėl laukai turėtų grąžinti `id` — cache reikia stabilaus rakto dublikatams pašalinti.

## Persisted queries + CDN

**Persisted queries** pakeičia užklausos tekstą maiša (hash). Klientas siunčia trumpą maišą vietoj ilgo POST turinio; serveris suranda užregistruotą užklausą.

```js
// Automatic Persisted Queries: pirmiausia mažytis GET vien su maiša
// GET /graphql?extensions={"persistedQuery":{"sha256Hash":"abc..."}}
// -> kadangi tai GET su stabiliu raktu, CDN gali kešuoti ATSAKYMĄ pakraštyje (edge)
```

Skaitymo užklausų pavertimas kešuojamais GET leidžia **CDN** aptarnauti jas pakraštyje (edge) ir sumažina turinio dydį. `@cacheControl` nuorodos (max-age, scope) leidžia serveriui deklaruoti kiekvieno lauko TTL, kurių paiso CDN ir Apollo serverio cache.

## Serverio pusėje

Atsakymų cache (pvz., Apollo), raktuojamas pagal užklausą + kintamuosius + autentifikacijos scope, leidžia išvengti pakartotinio resolverių vykdymo; DataLoader tvarko dublikatų pašalinimą vieno kreipinio ribose (tai kitas rūpestis — jis nėra tarp-kreipinių cache).

## Kodėl tai svarbu

Vieno endpoint / POST dizainas laužo naivų HTTP kešavimą, todėl interviuotojai nori išgirsti **sluoksniuotą** atsakymą: normalizuotas esybių cache kliente, persisted queries + `@cacheControl`, kad atrakintumėte CDN/edge kešavimą, ir kur įsipaišo DataLoader (vieno kreipinio, o ne tarp-kreipinių).

Normalizuotas kliento cache

Persisted queries + CDN

Serverio pusėje

Kodėl tai svarbu

Susiję klausimai