Làm sao để cache một API GraphQL?

Question

IT Interview Practice · Accepted Answer

Cache GraphQL khó hơn REST vì chỉ có một endpoint và request thường là POST, nên HTTP caching dựa trên URL không hoạt động ngay được. Thay vào đó bạn cache ở ba tầng: **client**, **transport/CDN**, và **server**.

## Normalized client cache

Apollo Client và Relay lưu kết quả trong một **normalized cache** đánh khóa theo `__typename` + `id`. Mỗi object được lưu một lần; các query khác nhau tham chiếu cùng `User:1` sẽ dùng chung nó, nên một mutation cập nhật một entity sẽ tự làm mới mọi view.

```graphql
# Cả hai query cùng ghi vào một mục normalized User:1 trong cache của client
query A { user(id: "1") { id name } }
query B { post(id: "9") { author { id name } } }  # author cũng là User:1
```

Đây là lý do field nên trả về `id` — cache cần một khóa ổn định để khử trùng lặp.

## Persisted query + CDN

**Persisted query** thay chuỗi query bằng một hash. Client gửi một hash ngắn thay vì thân POST dài; server tra cứu query đã đăng ký.

```js
// Automatic Persisted Queries: đầu tiên một GET nhỏ chỉ chứa hash
// GET /graphql?extensions={"persistedQuery":{"sha256Hash":"abc..."}}
// -> vì là GET có khóa ổn định, một CDN có thể cache RESPONSE ở edge
```

Biến query đọc thành GET cache-được cho phép **CDN** phục vụ chúng ở edge, và giảm kích thước payload. Các gợi ý `@cacheControl` (max-age, scope) cho phép server khai báo TTL theo từng field mà CDN và server cache của Apollo tuân theo.

## Phía server

Một response cache (ví dụ của Apollo) đánh khóa theo query + variables + phạm vi auth giúp tránh chạy lại resolver; DataLoader lo việc khử trùng lặp trong phạm vi một request (một vấn đề khác — nó không phải cache liên-request).

## Tại sao điều này quan trọng

Thiết kế một-endpoint/POST phá vỡ HTTP caching ngây thơ, nên người phỏng vấn muốn nghe câu trả lời **phân tầng**: normalized entity cache ở client, persisted query + `@cacheControl` để mở khóa cache CDN/edge, và vị trí của DataLoader (theo request, không phải liên-request).

Normalized client cache

Persisted query + CDN

Phía server

Tại sao điều này quan trọng

Câu hỏi liên quan