GraphQL là gì và tại sao nó đang trở thành lựa chọn thay thế REST API trong nhiều dự án web lớn? GraphQL là ngôn ngữ truy vấn và runtime cho API, cho phép client yêu cầu chính xác dữ liệu cần thiết trong một lần gọi duy nhất. Được Facebook phát triển từ năm 2012 và mã nguồn mở năm 2015, GraphQL đã trở thành tiêu chuẩn API được sử dụng bởi hàng triệu nhà phát triển toàn cầu, với package graphql trên npm đạt tới 189 triệu lượt tải mỗi tháng.
Trong bài viết này, chúng ta sẽ đi qua cách GraphQL hoạt động, ưu nhược điểm so với REST, và các công cụ phổ biến để bắt đầu xây dựng API với GraphQL.
GraphQL là gì?
GraphQL là một ngôn ngữ truy vấn (query language) cho API, kết hợp giữa khai báo (declarative) và kiểu mạnh (strongly typed). Thay vì REST mỗi tài nguyên một URL riêng, GraphQL sử dụng một endpoint duy nhất và client khai báo chính xác cấu trúc dữ liệu muốn nhận. Server trả về JSON theo đúng cấu trúc đó, không thừa không thiếu.
Một API GraphQL gồm ba thành phần chính: schema định nghĩa tất cả kiểu dữ liệu và mối quan hệ; resolver xác định cách lấy dữ liệu cho mỗi field; và ba loại thao tác là Query để đọc, Mutation để ghi, Subscription để nhận cập nhật real-time qua WebSocket. Clients có thể truy vấn schema qua introspection, giúp IDE như GraphiQL tự động gợi ý và kiểm tra lỗi khi viết truy vấn.
GraphQL hoạt động như thế nào?
Khi client gửi một query, GraphQL server thực hiện nhiều bước. Đầu tiên, kiểm tra cú pháp (parsing) xem query có đúng định dạng không. Sau đó, validation kiểm tra từng field có tồn tại trong schema không, kiểu dữ liệu có khớp không, và quyền truy cập có được phép không. Cuối cùng, execution chạy các resolver theo thứ tự dependencies để lấy dữ liệu, rồi trả về JSON phản hồi.
Điểm đặc biệt là resolver chạy độc lập cho mỗi field. Nếu query yêu cầu author.name và author.posts, resolver cho name và resolver cho posts chạy riêng biệt, có thể fetch từ các nguồn dữ liệu khác nhau trong cùng một query. Cơ chế DataLoader giúp gom các request lặp lại để tránh vấn đề N+1, nơi mỗi bài viết gọi riêng một query lấy tác giả gây chậm.
GraphQL vs REST: so sánh chi tiết
Sự khác biệt lớn nhất nằm ở cách client truy cập dữ liệu. REST dùng multiple endpoints, mỗi endpoint trả cấu trúc cố định do server định nghĩa. GraphQL dùng single endpoint, client tự quyết định cấu trúc response. Điều này ảnh hưởng trực tiếp đến hiệu suất mạng, đặc biệt trên mobile nơi mỗi round-trip đều có latency.
| Tiêu chí | REST | GraphQL |
|---|---|---|
| Endpoint | Nhiều endpoint theo resource | Single endpoint |
| Cấu trúc response | Server định nghĩa | Client khai báo |
| Over-fetching | Thường xảy ra | Không có |
| Round-trip | Nested data cần nhiều request | Một request lấy hết |
| Typing | Tùy chọn (OpenAPI) | Bắt buộc, strongly typed |
| Versioning | /v1, /v2 | Không cần version, thêm field mới |
| Caching HTTP | Tự nhiên theo URL GET | Cần client-side cache (Apollo/Relay) |
| Rate limiting | Đếm số request | Tính điểm query (GitHub: 5.000 pts/giờ) |
Ví dụ thực tế: GitHub cung cấp cả REST API lẫn GraphQL API. Với REST, để lấy thông tin repo cùng commits và contributors, bạn cần ba request riêng. Với GraphQL, tất cả nằm trong một query duy nhất, giảm đáng kể latency đặc biệt trên kết nối chậm.
Ưu điểm của GraphQL
GraphQL giải quyết nhiều vấn đề kinh niên của REST. Không có over-fetching hay under-fetching vì client chỉ lấy đúng field cần. Single endpoint giúp giảm số round-trip, đặc biệt quan trọng trên mobile app nơi mỗi kết nối đều tốn pin và bandwidth. Schema strongly typed giúp validate lỗi trước khi thực thi, tự phát hiện bugs từ sớm thay vì runtime.
Bản chất versionless của GraphQL cũng là lợi thế lớn. Thay vì duy trì nhiều phiên bản REST, ta chỉ thêm field mới và đánh dấu field cũ bằng directive @deprecated. Frontend và backend có thể phát triển song song dựa trên contract là schema, giảm phụ thuộc lẫn nhau giữa các team. GraphiQL playground giúp developer tự explore API mà không cần đọc tài liệu dài.
Nhược điểm cần biết
GraphQL không phải giải pháp vạn năng. Vấn đề caching phức tạp hơn REST vì không có URL-based HTTP cache tự nhiên. Cần sử dụng global object IDs kết hợp Apollo Cache hoặc Relay Store ở phía client để caching hiệu quả. Bài toán N+1 resolver cũng gây nhiều đau đầu nếu không dùng DataLoader batch properly.
File upload trong GraphQL cũng không trực tiếp như REST multipart/form-data, thường cần plugin graphql-upload hoặc upload qua REST endpoint riêng. Bảo vệ API khỏi query depth attack cần thiết lập giới hạn độ sâu và phức tạp query. Cuối cùng, hệ sinh thái tooling tuy phát triển nhanh nhưng vẫn non trẻ hơn REST vốn đã có hàng thập kỷ.
Các tổ chức sử dụng GraphQL
GraphQL đã được chứng minh ở quy mô lớn. Facebook, nơi khởi phát GraphQL, xử lý hàng triệu request mỗi giây qua mobile apps với cùng phiên bản API nhiều năm không thay đổi. GitHub cung cấp toàn bộ API qua GraphQL từ năm 2017, với cơ chế rate limiting tính theo điểm query và giới hạn 500.000 node mỗi request. Shopify dùng GraphQL cho cả Admin API lẫn Storefront API với cơ chế leaky-bucket rate limits.
Ngoài ra, Airbnb, Coursera, Intuit, New York Times và PayPal đều là những tổ chức lớn sử dụng GraphQL trong sản phẩm production. LinkedIn landscape.graphql.org liệt kê hàng trăm công ty sử dụng GraphQL ở nhiều quy mô khác nhau.
Các công cụ phổ biến
Bắt đầu với GraphQL, bạn sẽ cần chọn client library và server framework phù hợp. Apollo Client là lựa chọn phổ biến nhất trên JavaScript với 28 triệu lượt tải mỗi tháng trên npm và cộng đồng lớn. Relay, giải pháp của Meta, tập trung tối ưu hiệu suất cho React apps. Strapi, headless CMS với hơn 72.000 star trên GitHub, hỗ trợ GraphQL plugin built-in.
Trên server side, Hasura tạo API GraphQL tức thì từ PostgreSQL mà không cần viết resolver thủ công. graphql-js là reference implementation chính thức. GraphiQL cung cấp IDE playground trực quan để test và khám phá API. Python developer có thể dùng Strawberry hoặc Ariadne, cả hai đều hỗ trợ type hints và async.
Khi nào nên dùng GraphQL thay REST?
GraphQL phù hợp nhất khi frontend cần dữ liệu phức tạp từ nhiều nguồn, khi mobile app cần tối thiểu số round-trip, hoặc khi nhiều team cùng làm trên một API và cần contract rõ ràng. REST vẫn tốt hơn cho API đơn giản, caching HTTP quan trọng, hoặc khi team chỉ có backend developer quen REST. Nhiều hệ thống lớn dùng cả hai: GraphQL cho frontend-facing API và REST cho internal services.
Kết luận
GraphQL mang lại trải nghiệm linh hoạt và hiệu quả cho phát triển API, đặc biệt trong các dự án phức tạp với nhiều nguồn dữ liệu và nhiều client. Hiểu rõ ưu nhược điểm sẽ giúp bạn quyết định đúng khi nào nên áp dụng GraphQL. Bắt đầu với Apollo Server hoặc Hasura, thử với project nhỏ, rồi mở rộng dần khi đã quen thuộc với mô hình tư duy khai báo của GraphQL.
