GraphQL 是一个陷阱?

简介: 本文最初发布于Marc-André Giroux博客,由 InfoQ 中文站翻译并分享。

这个话题昨天在推特上爆发了,我想应该用更长的篇幅回顾一下作者的一些观点,澄清一些误解,我们一个个过一遍。

【推文 1 】GraphQL 使你的公共 API 等同于一个通用数据库,更糟糕的是——一个通用图形数据库,维护工作量高得惊人;锁定查询功能意味着你只是在运行普通的 API,但不锁定它意味着无限的性能工作。(查看推文)

主张 1 :GraphQL 使您的公共 API 等同于通用图形数据库

根据作者的说法,GraphQL 使我们的公共 API 等同于通用的图形数据库。如果您在过去几年里经常听说过 GraphQL,那么可能知道这是 GraphQL 最常见的误解之一。尽管有些 API 在设计上支持通用特性,但就像大多数 API 的风格一样,GraphQL API 是通用的还是特定的,是您自己决定的。

一个通用的 GraphQL API 与大多数人认为的最佳实践背道而驰。事实上,GraphQL 规范一直拒绝通用/类数据库功能(如过滤、排序等)的提议。

避免通用/类数据库模式在GraphQL官方网站上列为最佳实践,没有比这更明确的了。

构建一个 GraphQL 最好的模式是告诉客户端如何使用数据,而不是镜像旧的数据库模式。

公共 API 确实比内部 API 更通用一些,需要预测各种各样的场景调用,有时在客户端调用的公共 API 中也需要更“原始”的形式展示数据。虽然这不是 GraphQL。

主张 2 :维护工作量高得离谱

这是个很有意思的轶闻。相比其它风格的 API,我没有发现使用 GraphQL 更难维护,实际上可以说它更容易维护,但这可能是有点自欺,因为很多 GraphQL 项目都是新领域,通常比累积了技术债务的遗留 API 具有更好的可维护性。准确地说,我认为维护更多的是与软件本身的编写相关,而不是具体的技术选择。我并没有在这些推文中看到一个强有力的例子来说明 GraphQL 为什么难以维护。

主张 3 :锁定查询功能意味着你只是在使用普通的 API,而不锁定则意味着无限的性能工作

作者谈及的“锁定”像是持久查询,这意味着让 GraphQL “打开”(客户端能执行任意查询)会导致无限的性能工作,以下推文中的观点可能说得更具体。如我们所知,一个设计和实现良好的 GraphQL API 能够很好地处理任意查询,并在合理时间内提供查询服务。

锁定查询功能并不意味着你只是在使用“普通” API(不管这意味着什么),像持久化查询的服务仍然提供了很大的灵活性,服务端团队并不需要为每个新的持久化查询做额外的工作,模式(Schema)公开了这些可能性,即使查询以这种方式列入白名单(通常在构建时),但实际的调用仍由客户端决定。

【推文 2 】在任何应用程序中,管理对象生命周期都很困难,因为它们在内部具有图形化性质,公开时情况会更糟。如果可以充分考虑公开哪些连接,几乎每个系统都更容易预测和维护。 (查看推文)

我绝对同意,但这似乎与 GraphQL 无关。GraphQL API 公开的内容就是您选择公开的内容,而无需公开内部细节;重点是 GraphQL 中的连接是人为设计的,另外在 GraphQL 中避免不可预知的对象访问,与在典型的基于资源的 API 中所做相似。类似的想法也在下面的推文中。

【推文 3 】非图 API 的不良性能和生命周期错误已经够让我们心惊胆战了,面对如此大量的多对多连接时,还需要用户和我们自己来预测?这可不是人类能干的活儿,问题都成了吓人的玩意儿。(查看推文)

我认为这是 GraphQL 的一种权衡,GraphQL API 往往不能像其它 API 那样进行优化,因为它提供了一定的灵活性,这是设计的一部分,但对有些人来说这可能是设计的缺陷(尽管开销通常很小)。在构建 GraphQL API 时,有很多方法可以进行改善,比如正确设置批处理和缓存数据加载;如果您将对象类型视为 “资源”或“端点”时,安全性与其它 API 都非常相似。

【推文 4 】在 SQL 数据库中,典型的 GraphQL 需要查询中的嵌套查询和无限连接,这些都是众所周知的可靠性、性能、代码扩展性和理解性问题,是所有通用图形 API 问题的一种体现。(查看推文)

GraphQL 不需要那么复杂的 SQL 查询。其实,我很好奇作者是怎么得到的结论,这通常不是 GraphQL 执行导致的查询。如果说 GraphQL 有什么不成熟的实现,就是会为每个解析器产生大量的小查询,通过数据加载器,可以看到像是一组查询的子集(其中很多是 SELECT…WHERE…IN 查询)。如果需要构建预解析器或使用 GraphQL-to-SQL 的自动生成,才会用到查询中的嵌套查询和无限连接,只是在实际中不常见。

GraphQL 并不是一个通用的 Graph API。

image.png

【最后一条推文】另外还有一件事要讨论,如何让系统以可预测的、有限度的方式变慢,往往比让系统以不可预测的、无限度的方式变慢更有用,“不可预测”和“无限”延时通常同时出现。(查看推文)

我非常同意最后一条推文,这是一个很好的观点。GraphQL API,尤其是公共 API,不可能像服务器驱动的用例那样具有可预测性,因为服务器驱动的服务调用是预知并单独优化过的,简单实现的 GraphQL API 肯定会导致非常低效的数据加载。还好 GraphQL 的可观察性工具、数据加载技术和类库现在都有了,让我的 GraphQL API 具有预测性而且速度很快。

如果您不需要 GraphQL 的特性,那么的确不如直接丢几个 RPC 端点那样简单,而且用起来免不了带来更多的认知负担。

这个主题可以作为提醒在构建 GraphQL API 时不要做什么,然而有些地方像稻草人一样,错误地描述了 GraphQL 构建的目的。文末给大家一些小贴士:

  • 不要将 GraphQL API 设计成一个图形数据库,也不要根据数据库模式设计您的 API。
  • 尽可能使用异步/批处理数据加载(如数据加载器),不要创建基于预查询或 gql-to-sql 工具的复杂 SQL 查询(常规经验)。
  • 如果不能有效地支持通用特性,应避免使用它们,在需要且性能满足时再添加。
  • 如果 GraphQL 设计用来解决的那些问题您遇不到,那么也没有必要用它。
目录
相关文章
|
4月前
|
前端开发 数据管理 API
探究GraphQL在前端开发中的实际应用
在如今越来越复杂的前端应用程序中,数据管理变得更加困难,因此GraphQL成为了越来越受欢迎的解决方案。本文将介绍GraphQL在前端开发中的应用,以及它对开发过程所带来的好处。
|
3月前
|
Rust Java 调度
Rust中的异步编程利器:Tokio框架解析
在Rust生态系统中,Tokio已经成为异步编程的首选框架。本文将对Tokio进行深入探讨,分析其关键特性、工作原理以及如何在Rust项目中使用Tokio进行高效的异步编程。我们将通过示例代码展示Tokio如何简化异步操作,提升程序性能,并讨论Tokio在处理并发任务时的优势。
|
4月前
|
API 开发者 网络架构
从REST到GraphQL:探究GraphQL的概念与实践
RESTful API曾经是互联网应用程序的主流,但它也存在着一些限制。随着GraphQL的出现,开发者们可以更加自由地定义和查询API,提高了应用程序的灵活性和可扩展性。本文将深入探讨GraphQL的概念和实践,并介绍如何在应用程序中使用GraphQL。
22 6
|
4月前
|
存储 API 开发者
探究GraphQL:从概念到实践
GraphQL是一种用于API开发的查询语言,它具有灵活的数据获取能力和强大的类型系统。与传统RESTful API相比,GraphQL更加高效、可扩展和易于维护。本文将介绍GraphQL的基本概念、核心优势以及实践应用。
|
10月前
|
传感器 Web App开发 JavaScript
前端(六)——TypeScript在前端中的重要性与应用
前端(六)——TypeScript在前端中的重要性与应用
|
12月前
|
存储 JavaScript 前端开发
GraphQL 是干什么的?底层原理是什么?
GraphQL 是干什么的?底层原理是什么?
336 0
|
JavaScript 前端开发 API
|
JSON Unix API
graphql学习(五)
今天给之前的demo增加登录验证. 现在验证流行使用JWT(JSON web tokens),我们也选择用github.com/dgrijalva/jwt-go. 还是从models开始,增加user.
1133 0
graphql学习(五)
|
JavaScript 前端开发