返回资讯中心
外部精选
软件工程
#开发者实时流

GraphQL TSC 发布 GraphQL over HTTP 规范

来源标题:The GraphQL over HTTP Specification

GraphQL 技术指导委员会(TSC)发布首版 GraphQL over HTTP 规范,为主规范提供补充,但并不改变 GraphQL 本身的传输无关性。此前通过 HTTP 使用 GraphQL 缺乏统一规范,导致与其他 HTTP 工具和可观测性系统的互操作困难。该规范旨在帮助服务器、客户端、代理等组件更好地协同工作。

Hacker News 最新kklee2026/11/13 · 4 天前10 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

Announcing the GraphQL over HTTP specification announcements Announcing the GraphQL over HTTP specification GraphQL TSCNovember 12, 2026

自2015年GraphQL首次发布以来,GraphQL规范一直与传输方式无关。

GraphQL规范的大部分内容都是关于“服务”的:接收“请求”、执行请求并生成“响应”。至于这些请求和响应如何发送和接收,则由实现者自行决定。

这在总体上是有益的。你可以在本地机器上使用GraphQL,也可以通过原始TCP、信鸽,或者任何其他方式。然而,对于大量通过HTTP使用GraphQL的用户来说,缺乏规范使得与其他HTTP工具的互操作性以及可观测性变得比应有的更加困难。

今天,随着GraphQL over HTTP规范的首个版本发布,这种情况正在改变!

GraphQL规范仍然与传输方式无关;GraphQL over HTTP规范是一份新文档,作为主GraphQL规范的补充。

如果你正在通过HTTP使用GraphQL,请遵循该规范的指导,并确保你的服务器、客户端、代理和其他服务能够良好协作。

GraphQL over HTTP规范包含一个新的application/graphql-response+json媒体类型。

此前,许多GraphQL服务器使用application/json作为响应类型。这使得客户端难以区分来自源服务器的格式良好的GraphQL响应与来自代理、缓存或其他网络中间件的错误响应。

作为一种变通方案,大多数实现将状态码设置为200:如果客户端收到200状态码,它就知道响应未被篡改,可以安全地将其解析为GraphQL响应。

从可观测性的角度来看,这并不理想,还引发了一些关于“200 Not OK”的玩笑。如果一切都是200,就很难获取服务的真实状态……

当客户端收到application/graphql-response+json响应体时,它就知道可以将其解析为格式良好的GraphQL over HTTP响应,无论状态码是什么。

该规范包含了关于应使用哪些状态码的详细指导,但实现者可以选择使用更适合具体情况的替代状态码,只要与通用规则保持一致即可。常见状态码包括:

一个成功响应如下所示: HTTP/1.1 200 OK Content-Type: application/graphql-response+json ... "data": { "hello": "world"

一个请求错误如下所示:

撇开“200 Not OK”的问题不谈,在过去十年中,GraphQL over HTTP的许多方面一直运作良好。

本规范记录了所有这些内容::

它还包含了关于安全性、部分成功和未来兼容性的非规范性说明

IETF刚刚将QUERY HTTP动词推进为拟议标准。

QUERY非常适合GraphQL,我们已经有了支持它的计划。我们不想推迟这个初始版本或仓促实现,但我们希望在GraphQL over HTTP规范的下一个修订版中将其纳入。

另一个将从标准化中受益的领域是持久化文档(Persisted documents)。

持久化GraphQL文档(“持久化查询”)的技术自2015年GraphQL开源之前就一直在使用,不同的实现解决了不同的问题:性能、安全性、可观测性。

我们渴望与社区合作,构建一种标准方法,能够解决所有这些问题的同时保持未来的可扩展性。

最后,请求批处理将是一个重大改进,特别是在复合模式(Federation)的上下文中,或者向你不控制的模式发起请求时。

如果你是GraphQL用户,很可能你已经在不知不觉中使用了新规范!市面上大多数GraphQL框架和库已经支持新规范。

如果你是库作者,不妨试试新规范!

无论如何,请告诉我们你的想法!

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →