Kako cachirati GraphQL API?

Question

IT Interview Practice · Accepted Answer

Cachiranje GraphQL-a teže je nego REST-a jer postoji jedna krajnja točka, a zahtjevi su obično POST, pa HTTP cachiranje temeljeno na URL-u ne radi odmah. Umjesto toga cachirate na tri sloja: **klijent**, **transport/CDN** i **poslužitelj**.

## Normalizirani cache na klijentu

Apollo Client i Relay pohranjuju rezultate u **normalizirani cache** s ključem `__typename` + `id`. Svaki objekt pohranjen je jednom; različiti upiti koji referenciraju isti `User:1` dijele ga, pa mutacija koja ažurira jedan entitet automatski osvježava svaki prikaz.

```graphql
# Oba upita pišu u isti normalizirani unos User:1 u cacheu klijenta
query A { user(id: "1") { id name } }
query B { post(id: "9") { author { id name } } }  # author je također User:1
```

Zato bi polja trebala vraćati `id` — cache treba stabilan ključ za deduplikaciju.

## Persisted queries + CDN

**Persisted queries** zamjenjuju string upita hashom. Klijent šalje kratki hash umjesto dugog POST tijela; poslužitelj traži registrirani upit.

```js
// Automatic Persisted Queries: prvo maleni GET sa samo hashom
// GET /graphql?extensions={"persistedQuery":{"sha256Hash":"abc..."}}
// -> budući da je to GET sa stabilnim ključem, CDN može cachirati ODGOVOR na rubu (edge)
```

Pretvaranje upita za čitanje u cachirajuće GET-ove omogućuje **CDN-u** da ih poslužuje na rubu i smanjuje payloade. `@cacheControl` savjeti (max-age, scope) omogućuju poslužitelju da deklarira TTL-ove po polju koje CDN i Apollo poslužiteljski cache poštuju.

## Na strani poslužitelja

Cache odgovora (npr. Apollov) s ključem upit + varijable + opseg autentifikacije izbjegava ponovno pokretanje resolvera; DataLoader rukuje deduplikacijom po zahtjevu (drugačija briga — nije cache preko zahtjeva).

## Zašto je to važno

Dizajn s jednom krajnjom točkom/POST-om lomi naivno HTTP cachiranje, pa ispitivači žele čuti **slojeviti** odgovor: normalizirani cache entiteta na klijentu, persisted queries + `@cacheControl` za otključavanje CDN/edge cachiranja, te gdje DataLoader spada (po zahtjevu, ne preko zahtjeva).

Normalizirani cache na klijentu

Persisted queries + CDN

Na strani poslužitelja

Zašto je to važno

Povezana pitanja