GraphQL vs REST：技术选型的七个关键考量

# GraphQL vs REST：技术选型的七个关键考量 ## 1. 查询灵活性 REST 每个端点返回固定结构，客户端可能产生 Over-fetching 或 Under-fetching。GraphQL 允许客户端精确声明所需字段： ```graphql query { user(id: "123") { name email posts(first: 5) { title createdAt } } } ``` **结论**：前端需求变化频繁时 GraphQL 更灵活。 ## 2. 缓存策略 REST 天然支持 HTTP 缓存（ETag、Cache-Control），CDN 友好。GraphQL 通常走 POST 请求，需要借助 Apollo Client 等库实现客户端缓存。 **结论**：缓存要求高时 REST 更简单。 ## 3. 错误处理 REST 使用 HTTP 状态码（404、500），语义清晰。GraphQL 始终返回 200，错误信息放在 `errors` 字段中。 ```json { "data": null, "errors": [ {"message": "User not found", "path": ["user"]} ] } ``` ## 4. 文件上传 REST 原生支持 multipart/form-data。GraphQL 需要额外规范（如 graphql-upload）。 ## 5. 实时订阅 GraphQL Subscription 基于 WebSocket，比 REST 轮询更高效。 ## 6. N+1 问题 GraphQL 嵌套查询容易触发 N+1 查询，需借助 DataLoader 批量加载。REST 在后端控制 SQL，更容易优化。 ## 7. 学习曲线 REST 概念简单，团队上手快。GraphQL 需要学习 Schema 定义、Resolver 编写、客户端缓存等概念。 ## 结论 没有绝对的优劣。内部管理系统、BFF 层适合 GraphQL；公开 API、高缓存需求场景适合 REST。