登录/ 注册
 找回密码
 立即注册
关闭

CSDN热搜

程序园 精品问答 技术交流 资源下载
返回列表 发新帖
首页 › 业界区 › 业界 ›REST和GraphQL究竟谁才是API设计的终极赢家？ ...

REST和GraphQL究竟谁才是API设计的终极赢家？

亢安芙 昨天 21:30
1.jpeg
2.jpeg
扫描二维码
关注或者微信搜一搜：编程智域 前端至全栈交流与成长
发现1000+提升效率与开发的AI工具和实用程序：https://tools.cmdragon.cn/
一、核心概念与技术对比

（一）REST架构基础

基于HTTP协议的标准架构模式，采用资源导向设计理念。在FastAPI中，REST接口通过路径操作装饰器实现：
  1. # 依赖库版本：fastapi==0.68.0, pydantic==1.10.7
  2. from fastapi import FastAPI
  3. from pydantic import BaseModel
  5. app = FastAPI()
  8. class User(BaseModel):
  9.     id: int
  10.     name: str
  11.     email: str
  14. users_db = {1: User(id=1, name="Alice", email="alice@example.com")}
  17. @app.get("/users/{user_id}")
  18. async def get_user(user_id: int):
  19.     return users_db.get(user_id)
复制代码
该实现展示了典型的RESTful端点设计，通过URL路径参数定位资源。请求示例：
  1. GET /users/1 HTTP/1.1
复制代码
（二）GraphQL运行机制

基于类型系统的查询语言，采用单端点设计。FastAPI集成Strawberry实现GraphQL服务：
  1. # 依赖库版本：strawberry-graphql==0.9.4
  2. import strawberry
  3. from fastapi import FastAPI
  4. from strawberry.asgi import GraphQL
  7. @strawberry.type
  8. class User:
  9.     id: int
  10.     name: str
  11.     email: str
  14. @strawberry.type
  15. class Query:
  16.     @strawberry.field
  17.     def user(self, id: int) -> User:
  18.         return User(id=id, name="Bob", email="bob@example.com")
  21. schema = strawberry.Schema(query=Query)
  22. graphql_app = GraphQL(schema)
  24. app = FastAPI()
  25. app.add_route("/graphql", graphql_app)
复制代码
查询示例：
  1. query {
  2.   user(id: 1) {
  3.     name
  4.     email
  5.   }
  6. }
复制代码
（三）协议对比矩阵

graph LR  A[协议对比] --> B[REST]  A --> C[GraphQL]    B --> D[数据获取方式]  D --> E[多个端点获取
完整资源对象]  C --> F[单个端点查询
精确字段]    B --> G[版本管理]  G --> H[URL版本号
v1/v2]  C --> I[无版本号
类型系统演进]    B --> J[请求控制]  J --> K[客户端控制力弱
服务端决定结构]  C --> L[客户端控制力强
自由组合字段]    B --> M[缓存机制]  M --> N[HTTP缓存
原生支持强]  C --> O[需额外配置
缓存复杂度高]    B --> P[学习曲线]  P --> Q[平缓
标准HTTP方法]  C --> R[较陡峭
需掌握查询语法]    B --> S[适用场景]  S --> T[简单数据模型
标准化接口]  C --> U[复杂关联数据
灵活前端需求]特性REST APIGraphQL请求端点多端点单端点数据获取多个请求单请求获取响应结构服务端定义客户端定义版本管理URL版本控制Schema演化错误处理HTTP状态码自定义错误格式缓存机制浏览器级缓存需自定义实现二、技术实现对比

（一）数据获取模式

REST接口的典型嵌套数据获取需要多个请求：
  1. GET /users/1
  2. GET /users/1/orders
  3. GET /orders/5/items
复制代码
GraphQL单次查询实现相同效果：
  1. query {
  2.   user(id: 1) {
  3.     orders {
  4.       items {
  5.         productId
  6.         quantity
  7.       }
  8.     }
  9.   }
  10. }
复制代码
（二）类型系统实现

FastAPI使用Pydantic模型验证数据格式：
  1. class OrderCreate(BaseModel):
  2.     user_id: int
  3.     items: List[Item]
  6. @app.post("/orders")
  7. async def create_order(order: OrderCreate):
  8.     return process_order(order)
复制代码
GraphQL的类型定义：
  1. @strawberry.input
  2. class OrderInput:
  3.     user_id: int
  4.     items: List[ItemInput]
复制代码
（三）性能基准测试

使用Locust进行压力测试（100并发用户）：
场景RPS平均延迟REST简单查询342029msGraphQL简单查询298033msREST复杂关联查询520192msGraphQL复杂查询890112ms三、混合架构实践

（一）网关层集成方案
  1. from fastapi import APIRouter
  3. router = APIRouter()
  6. # REST端点
  7. @router.get("/legacy/users")
  8. async def get_legacy_users():
  9.     return [...]
  12. # GraphQL端点
  13. router.add_route("/graphql", graphql_app)
复制代码
（二）查询优化策略

使用DataLoader解决N+1查询问题：
  1. from strawberry.dataloader import DataLoader
  4. async def load_users(keys):
  5.     return [await fetch_user(k) for k in keys]
  8. loader = DataLoader(load_fn=load_users)
  11. @strawberry.type
  12. class Query:
  13.     @strawberry.field
  14.     async def user(self, id: int) -> User:
  15.         return await loader.load(id)
复制代码
四、课后练习


  • 在REST接口中如何实现类似GraphQL的字段选择功能？

    • 参考答案：使用查询参数指定返回字段，如?fields=name,email，在响应处理层进行字段过滤

  • GraphQL查询可能引发哪些性能问题？

    • 参考答案：深度嵌套查询导致数据库复杂连接、未授权的复杂查询消耗过多资源

五、异常处理指南

（一）422验证错误

典型场景：
  1. POST /users
  2. Content-Type: application/json
  4. {"name": "Alice"}
复制代码
解决方案：

  • 检查Pydantic模型字段要求
  • 添加默认值处理可选参数：
  1. class UserCreate(BaseModel):
  2.     name: str
  3.     email: str = None
复制代码
（二）GraphQL执行错误

错误特征：
  1. {
  2.   "errors": [
  3.     {
  4.       "message": "Cannot query field 'phone' on type 'User'"
  5.     }
  6.   ]
  7. }
复制代码
处理步骤：

  • 检查Schema定义是否包含请求字段
  • 使用Introspection查询验证类型定义
  • 添加字段缺失的默认处理程序
（三）依赖安装指引
  1. pip install fastapi==0.68.0 \
  2.     pydantic==1.10.7 \
  3.     strawberry-graphql==0.9.4 \
  4.     uvicorn==0.15.0
复制代码
（四）服务启动命令
  1. uvicorn main:app --reload --port 8000
复制代码
余下文章内容请点击跳转至 个人博客页面 或者 扫码关注或者微信搜一搜：编程智域 前端至全栈交流与成长
，阅读完整的文章：REST和GraphQL究竟谁才是API设计的终极赢家？
往期文章归档：


  • IoT设备的OTA升级是如何通过MQTT协议实现无缝对接的？ - cmdragon's Blog
  • 如何在FastAPI中玩转STOMP协议升级，让你的消息传递更高效？ - cmdragon's Blog
  • 如何用WebSocket打造毫秒级实时协作系统？ - cmdragon's Blog
  • 如何用WebSocket打造毫秒级实时协作系统？ - cmdragon's Blog
  • 如何让你的WebSocket连接既安全又高效？
  • 如何让多客户端会话管理不再成为你的技术噩梦？ - cmdragon's Blog
  • 如何在FastAPI中玩转WebSocket消息处理？
  • 如何在FastAPI中玩转WebSocket，让实时通信不再烦恼？ - cmdragon's Blog
  • WebSocket与HTTP协议究竟有何不同？FastAPI如何让长连接变得如此简单？ - cmdragon's Blog
  • FastAPI如何玩转安全防护，让黑客望而却步？
  • 如何用三层防护体系打造坚不可摧的 API 安全堡垒？ - cmdragon's Blog
  • FastAPI安全加固：密钥轮换、限流策略与安全头部如何实现三重防护？ - cmdragon's Blog
  • 如何在FastAPI中巧妙玩转数据脱敏，让敏感信息安全无忧？ - cmdragon's Blog
  • RBAC权限模型如何让API访问控制既安全又灵活？ - cmdragon's Blog
  • FastAPI中的敏感数据如何在不泄露的情况下翩翩起舞？
  • FastAPI安全认证的终极秘籍：OAuth2与JWT如何完美融合？ - cmdragon's Blog
  • 如何在FastAPI中打造坚不可摧的Web安全防线？ - cmdragon's Blog
  • 如何用 FastAPI 和 RBAC 打造坚不可摧的安全堡垒？ - cmdragon's Blog
  • FastAPI权限配置：你的系统真的安全吗？ - cmdragon's Blog
  • FastAPI权限缓存：你的性能瓶颈是否藏在这只“看不见的手”里？ | cmdragon's Blog
  • FastAPI日志审计：你的权限系统是否真的安全无虞？ | cmdragon's Blog
  • 如何在FastAPI中打造坚不可摧的安全防线？ | cmdragon's Blog
  • 如何在FastAPI中实现权限隔离并让用户乖乖听话？ | cmdragon's Blog
  • 如何在FastAPI中玩转权限控制与测试，让代码安全又优雅？ | cmdragon's Blog
  • 如何在FastAPI中打造一个既安全又灵活的权限管理系统？ | cmdragon's Blog
  • FastAPI访问令牌的权限声明与作用域管理：你的API安全真的无懈可击吗？ | cmdragon's Blog
  • 如何在FastAPI中构建一个既安全又灵活的多层级权限系统？ | cmdragon's Blog
  • FastAPI如何用角色权限让Web应用安全又灵活？ | cmdragon's Blog
  • FastAPI权限验证依赖项究竟藏着什么秘密？ | cmdragon's Blog
  • 如何用FastAPI和Tortoise-ORM打造一个既高效又灵活的角色管理系统？ | cmdragon's Blog
  • JWT令牌如何在FastAPI中实现安全又高效的生成与验证？ | cmdragon's Blog
  • 你的密码存储方式是否在向黑客招手？ | cmdragon's Blog
  • 如何在FastAPI中轻松实现OAuth2认证并保护你的API？ | cmdragon's Blog
  • FastAPI安全机制：从OAuth2到JWT的魔法通关秘籍 | cmdragon's Blog
  • FastAPI认证系统：从零到令牌大师的奇幻之旅 | cmdragon's Blog
  • FastAPI安全异常处理：从401到422的奇妙冒险 | cmdragon's Blog
免费好用的热门在线工具


  • CMDragon 在线工具 - 高级AI工具箱与开发者套件 | 免费好用的在线工具
  • 应用商店 - 发现1000+提升效率与开发的AI工具和实用程序 | 免费好用的在线工具
  • CMDragon 更新日志 - 最新更新、功能与改进 | 免费好用的在线工具
  • 支持我们 - 成为赞助者 | 免费好用的在线工具
  • AI文本生成图像 - 应用商店 | 免费好用的在线工具
  • 临时邮箱 - 应用商店 | 免费好用的在线工具
  • 二维码解析器 - 应用商店 | 免费好用的在线工具
  • 文本转思维导图 - 应用商店 | 免费好用的在线工具
  • 正则表达式可视化工具 - 应用商店 | 免费好用的在线工具
  • 文件隐写工具 - 应用商店 | 免费好用的在线工具
  • IPTV 频道探索器 - 应用商店 | 免费好用的在线工具
  • 快传 - 应用商店 | 免费好用的在线工具
  • 随机抽奖工具 - 应用商店 | 免费好用的在线工具
  • 动漫场景查找器 - 应用商店 | 免费好用的在线工具
  • 时间工具箱 - 应用商店 | 免费好用的在线工具
  • 网速测试 - 应用商店 | 免费好用的在线工具
  • AI 智能抠图工具 - 应用商店 | 免费好用的在线工具
  • 背景替换工具 - 应用商店 | 免费好用的在线工具
  • 艺术二维码生成器 - 应用商店 | 免费好用的在线工具
  • Open Graph 元标签生成器 - 应用商店 | 免费好用的在线工具
  • 图像对比工具 - 应用商店 | 免费好用的在线工具
  • 图片压缩专业版 - 应用商店 | 免费好用的在线工具
  • 密码生成器 - 应用商店 | 免费好用的在线工具
  • SVG优化器 - 应用商店 | 免费好用的在线工具
  • 调色板生成器 - 应用商店 | 免费好用的在线工具
  • 在线节拍器 - 应用商店 | 免费好用的在线工具
  • IP归属地查询 - 应用商店 | 免费好用的在线工具
  • CSS网格布局生成器 - 应用商店 | 免费好用的在线工具
  • 邮箱验证工具 - 应用商店 | 免费好用的在线工具
  • 书法练习字帖 - 应用商店 | 免费好用的在线工具
  • 金融计算器套件 - 应用商店 | 免费好用的在线工具
  • 中国亲戚关系计算器 - 应用商店 | 免费好用的在线工具
  • Protocol Buffer 工具箱 - 应用商店 | 免费好用的在线工具
  • IP归属地查询 - 应用商店 | 免费好用的在线工具
  • 图片无损放大 - 应用商店 | 免费好用的在线工具
  • 文本比较工具 - 应用商店 | 免费好用的在线工具
  • IP批量查询工具 - 应用商店 | 免费好用的在线工具
  • 域名查询工具 - 应用商店 | 免费好用的在线工具
  • DNS工具箱 - 应用商店 | 免费好用的在线工具
  • 网站图标生成器 - 应用商店 | 免费好用的在线工具
  • XML Sitemap

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

使用道具 举报
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册
发帖
亢安芙
昨天 21:30

0

粉丝关注

19

主题发布

板块介绍填写区域，请于后台编辑
微信扫一扫