คุณทำ cache ให้กับ GraphQL API อย่างไร?

Question

IT Interview Practice · Accepted Answer

การ cache GraphQL ยากกว่า REST เพราะมี endpoint เดียวและ request มักเป็น POST การ cache แบบ HTTP ที่อิงกับ URL จึงใช้ไม่ได้ทันที คุณต้อง cache ที่สามชั้นแทน: **client**, **transport/CDN** และ **server**

## Normalized cache ฝั่ง client

Apollo Client และ Relay เก็บผลลัพธ์ไว้ใน **normalized cache** ที่ใช้ `__typename` + `id` เป็น key ทุก object ถูกเก็บเพียงครั้งเดียว query ต่าง ๆ ที่อ้างถึง `User:1` เดียวกันจะใช้ร่วมกัน ดังนั้น mutation ที่อัปเดต entity หนึ่งจึงรีเฟรชทุกมุมมองโดยอัตโนมัติ

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

นี่คือเหตุผลที่ field ควรส่งคืน `id` — cache ต้องมี key ที่เสถียรเพื่อขจัดความซ้ำซ้อน (deduplicate)

## Persisted query + CDN

**Persisted query** แทนที่ query string ด้วย hash client ส่ง hash สั้น ๆ แทน POST body ที่ยาว แล้ว server จะไปค้นหา query ที่ลงทะเบียนไว้

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

การเปลี่ยน query ที่อ่านข้อมูลให้กลายเป็น GET ที่ cache ได้ ทำให้ **CDN** เสิร์ฟมันได้ที่ edge และลดขนาด payload คำใบ้ `@cacheControl` (max-age, scope) ให้ server ประกาศ TTL ต่อ field ที่ทั้ง CDN และ cache ของ Apollo server เคารพตาม

## ฝั่ง server

response cache (เช่นของ Apollo) ที่ใช้ query + variable + auth scope เป็น key ช่วยหลีกเลี่ยงการรัน resolver ซ้ำ ส่วน DataLoader จัดการการขจัดความซ้ำซ้อนภายใน request เดียว (เป็นคนละเรื่อง — มันไม่ใช่ cache ข้าม request)

## ทำไมจึงสำคัญ

การออกแบบแบบ endpoint เดียว/POST ทำให้ HTTP caching ตรงไปตรงมาใช้ไม่ได้ ผู้สัมภาษณ์จึงอยากได้ยินคำตอบแบบ **แบ่งเป็นชั้น**: normalized entity cache ฝั่ง client, persisted query + `@cacheControl` เพื่อปลดล็อกการ cache ที่ CDN/edge และ DataLoader เข้ามาตรงไหน (ต่อ request ไม่ใช่ข้าม request)

Normalized cache ฝั่ง client

Persisted query + CDN

ฝั่ง server

ทำไมจึงสำคัญ

คำถามที่เกี่ยวข้อง