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

扫描二维码
关注或者微信搜一搜：编程智域 前端至全栈交流与成长

发现1000+提升效率与开发的AI工具和实用程序：https://tools.cmdragon.cn/

一、核心概念与技术对比

（一）REST架构基础

基于HTTP协议的标准架构模式，采用资源导向设计理念。在FastAPI中，REST接口通过路径操作装饰器实现：

# 依赖库版本：fastapi==0.68.0, pydantic==1.10.7
from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()


class User(BaseModel):
    id: int
    name: str
    email: str


users_db = {1: User(id=1, name="Alice", email="alice@example.com")}


@app.get("/users/{user_id}")
async def get_user(user_id: int):
    return users_db.get(user_id)

该实现展示了典型的RESTful端点设计，通过URL路径参数定位资源。请求示例：

GET /users/1 HTTP/1.1

（二）GraphQL运行机制

基于类型系统的查询语言，采用单端点设计。FastAPI集成Strawberry实现GraphQL服务：

# 依赖库版本：strawberry-graphql==0.9.4
import strawberry
from fastapi import FastAPI
from strawberry.asgi import GraphQL


@strawberry.type
class User:
    id: int
    name: str
    email: str


@strawberry.type
class Query:
    @strawberry.field
    def user(self, id: int) -> User:
        return User(id=id, name="Bob", email="bob@example.com")


schema = strawberry.Schema(query=Query)
graphql_app = GraphQL(schema)

app = FastAPI()
app.add_route("/graphql", graphql_app)

查询示例：

query {
  user(id: 1) {
    name
    email
  }
}

（三）协议对比矩阵

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

二、技术实现对比

（一）数据获取模式

REST接口的典型嵌套数据获取需要多个请求：

GET /users/1
GET /users/1/orders
GET /orders/5/items

GraphQL单次查询实现相同效果：

query {
  user(id: 1) {
    orders {
      items {
        productId
        quantity
      }
    }
  }
}

（二）类型系统实现

FastAPI使用Pydantic模型验证数据格式：

class OrderCreate(BaseModel):
    user_id: int
    items: List[Item]


@app.post("/orders")
async def create_order(order: OrderCreate):
    return process_order(order)

GraphQL的类型定义：

@strawberry.input
class OrderInput:
    user_id: int
    items: List[ItemInput]

（三）性能基准测试

使用Locust进行压力测试（100并发用户）：

三、混合架构实践

（一）网关层集成方案

from fastapi import APIRouter

router = APIRouter()


# REST端点
@router.get("/legacy/users")
async def get_legacy_users():
    return [...]


# GraphQL端点
router.add_route("/graphql", graphql_app)

（二）查询优化策略

使用DataLoader解决N+1查询问题：

from strawberry.dataloader import DataLoader


async def load_users(keys):
    return [await fetch_user(k) for k in keys]


loader = DataLoader(load_fn=load_users)


@strawberry.type
class Query:
    @strawberry.field
    async def user(self, id: int) -> User:
        return await loader.load(id)

四、课后练习

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

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

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

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

五、异常处理指南

（一）422验证错误

典型场景：

POST /users
Content-Type: application/json

{"name": "Alice"}

解决方案：

1. 检查Pydantic模型字段要求
2. 添加默认值处理可选参数：

class UserCreate(BaseModel):
    name: str
    email: str = None

（二）GraphQL执行错误

错误特征：

{
  "errors": [
    {
      "message": "Cannot query field 'phone' on type 'User'"
    }
  ]
}

处理步骤：

1. 检查Schema定义是否包含请求字段
2. 使用Introspection查询验证类型定义
3. 添加字段缺失的默认处理程序

（三）依赖安装指引

pip install fastapi==0.68.0 \
    pydantic==1.10.7 \
    strawberry-graphql==0.9.4 \
    uvicorn==0.15.0

（四）服务启动命令

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

来源链接：https://www.cnblogs.com/Amd794/p/18984781