0

0

GraphQL与REST在javascript中使用有何不同【教程】

夢幻星辰

夢幻星辰

发布时间:2026-01-31 17:53:34

|

306人浏览过

|

来源于php中文网

原创

GraphQL与REST的核心差异在于请求逻辑组织方式:GraphQL将数据获取逻辑移至前端查询语句,统一通过POST请求发送字符串化查询;REST则依赖URL路径和HTTP方法约定资源行为。

graphql与rest在javascript中使用有何不同【教程】

GraphQL 和 REST 在 JavaScript 中的使用差异,不在于“哪个更好”,而在于“请求逻辑怎么组织”——GraphQL 把数据获取逻辑从后端路由转移到前端查询语句里,REST 则靠 URL 路径和 HTTP 方法约定资源行为。

如何发请求:fetch 调用方式不同

REST 通常用 fetch('/api/users/123')axios.get('/api/users/123'),URL 本身携带资源定位信息;GraphQL 统一走一个 endpoint(比如 /graphql),所有请求都用 POST,主体是字符串化的查询语句。

常见错误:直接把 GraphQL 查询当 GET 参数拼在 URL 后,导致 405 或空响应。必须用 fetchmethod: 'POST' + body: JSON.stringify({ query, variables })

实操建议:

立即学习Java免费学习笔记(深入)”;

  • REST 请求可直接用 URLSearchParams 构建查询参数,GraphQL 必须序列化整个 query 字段
  • GraphQL 响应体固定为 { data, errors } 结构,REST 响应格式完全由后端决定(可能 200 返回数组,也可能 200 返回 { result: [...] })
  • 调试时,REST 看 Network Tab 的 URL 和 Response 就能判断问题;GraphQL 需点开 Request Payload 查 query 字符串是否拼错字段名

前端数据结构预期:字段由你声明,不是由 API 文档决定

REST 接口返回什么字段,前端只能被动接收(比如 GET /api/posts 总是返回 { id, title, author_name, created_at });GraphQL 允许你在请求里写 query { posts { id title } },后端只返回这两个字段。

这意味着:

  • 前端组件不再需要处理“多余字段”或“字段嵌套过深”,但必须自己维护查询语句与 UI 字段的同步(改 UI 字段名时,query 里也得改)
  • 没有“版本号”概念,但有“字段废弃”风险:如果后端删了 user.avatarUrl,而你的查询还写着它,就会在 errors 里报错,而不是静默返回 null
  • 联表数据(如文章+作者+评论)不用发多个请求,一个查询就能写完:posts { title author { name } comments { text } }

错误处理机制:HTTP 状态码 vs GraphQL 错误对象

REST 下,404 表示资源不存在,401 表示未登录,500 表示服务异常——你可以用 response.status 做粗粒度判断;GraphQL 即使后端崩了,HTTP 状态码也常是 200,真正错误藏在响应体的 errors 数组里。

AIFreePhp企业建站系统
AIFreePhp企业建站系统

AiFreePhp(爱免费php企业建站程序是一个免费开源的PHP建站程序),基于PHP + MYSQL 与模板技术,具有产品展示,文章栏目,下载管理,友情链接等功能。无任何限制功能,程序简单实用,可用于中小企业网站建设,不收取任何费用。使用本程序,不可将程序变相转售,二次开发发布。 运行安装目/install/index.php一般要求安装在站点的根目录,不是根目录有试过有没有问题,请大家尽量以

下载

典型现象:调用 GraphQL 后 response.ok === true,但数据没出来,console.log(data)null,必须检查 response.data.errors

实操建议:

立即学习Java免费学习笔记(深入)”;

  • 不要依赖 catch 捕获网络错误以外的业务错误;GraphQL 的字段校验失败、权限拒绝、解析错误都会进 errors,而非 JS 异常
  • 避免写 if (!data) throw new Error('no data') —— 正常情况下 data 可能部分为空(比如某个嵌套字段被拒绝),但整体响应仍是成功的
  • 错误提示需解析 errors[0].message,而不是看 HTTP 状态码

开发工具链:Apollo Client 不是必需,但省掉大量样板代码

纯 fetch 调用 GraphQL 完全可行,但很快会遇到缓存、变量注入、类型提示、错误重试等问题。Apollo Client 提供 useQueryuseMutation 等 Hook,自动管理 loading/error/data 状态,且支持本地缓存(比如两次请求相同 query,第二次可能直接读内存)。

而 REST 场景下,很多人直接手写 useState + useEffect + fetch,或用 SWR/React Query——它们也支持 GraphQL,但 Apollo 对 GraphQL 协议的支持更原生(比如自动提取 __typename 用于缓存键生成)。

注意点:

  • Apollo 默认开启缓存,可能导致 UI 没更新(比如 mutation 后没触发 refetch);REST 工具如 React Query 默认不缓存 POST 请求
  • gql 模板字符串标签(来自 @apollo/client)只是语法糖,本质还是字符串,但它支持 IDE 插件做字段名自动补全和验证
  • 如果你只用 GraphQL 做一次性查询,不关心缓存和状态同步,硬上 Apollo 反而增加 bundle 体积

最易被忽略的一点:GraphQL 查询语句是运行时拼接的字符串,不是 JS 对象——少一个 } 或字段名大小写错,不会在编译时报错,而是在发请求后才在 errors 里暴露。上线前务必用真实 schema 校验查询,别只靠眼力检查。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Python GraphQL API 开发实战
Python GraphQL API 开发实战

本专题系统讲解 Python 在 GraphQL API 开发中的实际应用,涵盖 GraphQL 基础概念、Schema 设计、Query 与 Mutation 实现、权限控制、分页与性能优化,以及与现有 REST 服务和数据库的整合方式。通过完整示例,帮助学习者掌握 使用 Python 构建高扩展性、前后端协作友好的 GraphQL 接口服务,适用于中大型应用与复杂数据查询场景。

16

2026.01.21

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

420

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

536

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

313

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

77

2025.09.10

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

237

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

479

2024.03.01

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

783

2023.08.22

2026赚钱平台入口大全
2026赚钱平台入口大全

2026年最新赚钱平台入口汇总,涵盖任务众包、内容创作、电商运营、技能变现等多类正规渠道,助你轻松开启副业增收之路。阅读专题下面的文章了解更多详细内容。

54

2026.01.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 4.4万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.0万人学习

React核心原理新老生命周期精讲
React核心原理新老生命周期精讲

共12课时 | 1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号