Πώς κάνεις cache ένα GraphQL API;

Question

IT Interview Practice · Accepted Answer

Το caching στο GraphQL είναι δυσκολότερο από ό,τι στο REST, επειδή υπάρχει ένα endpoint και τα αιτήματα είναι συνήθως POST, οπότε το HTTP caching βασισμένο σε URL δεν λειτουργεί εκ των προτέρων. Αντ' αυτού κάνεις cache σε τρία επίπεδα: **client**, **transport/CDN** και **server**.

## Normalized client cache

Ο Apollo Client και το Relay αποθηκεύουν τα αποτελέσματα σε ένα **normalized cache** με key το `__typename` + `id`. Κάθε αντικείμενο αποθηκεύεται μία φορά· διαφορετικά queries που αναφέρονται στον ίδιο `User:1` το μοιράζονται, οπότε μια mutation που ενημερώνει μία οντότητα ανανεώνει αυτόματα κάθε view.

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

Γι' αυτό τα πεδία πρέπει να επιστρέφουν `id` — το cache χρειάζεται ένα σταθερό key για να απαλείφει τα διπλότυπα.

## Persisted queries + CDN

Τα **persisted queries** αντικαθιστούν τη συμβολοσειρά του ερωτήματος με ένα hash. Ο client στέλνει ένα σύντομο hash αντί για ένα μεγάλο σώμα POST· ο server αναζητά το καταχωρημένο ερώτημα.

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

Η μετατροπή των read queries σε cache-able GETs επιτρέπει σε ένα **CDN** να τα σερβίρει στο edge και μειώνει τα payloads. Τα hints `@cacheControl` (max-age, scope) επιτρέπουν στον server να δηλώνει TTLs ανά πεδίο, τα οποία σέβονται το CDN και το cache του Apollo server.

## Στην πλευρά του server

Ένα response cache (π.χ. του Apollo) με key το query + variables + auth scope αποφεύγει την επανεκτέλεση των resolvers· το DataLoader χειρίζεται την απάλειψη διπλότυπων ανά αίτημα (διαφορετικό ζήτημα — δεν είναι cross-request cache).

## Γιατί έχει σημασία

Ο σχεδιασμός με ένα endpoint/POST σπάει το αφελές HTTP caching, οπότε οι συνεντευκτές θέλουν να ακούσουν τη **στρωματοποιημένη** απάντηση: normalized entity cache στον client, persisted queries + `@cacheControl` για να ξεκλειδώσεις το caching σε CDN/edge, και το πού ταιριάζει το DataLoader (ανά αίτημα, όχι cross-request).

Normalized client cache

Persisted queries + CDN

Στην πλευρά του server

Γιατί έχει σημασία

Σχετικές ερωτήσεις