GraphQL TSC 发布 GraphQL over HTTP 规范
来源标题:The GraphQL over HTTP Specification
GraphQL 技术指导委员会(TSC)发布首版 GraphQL over HTTP 规范,为主规范提供补充,但并不改变 GraphQL 本身的传输无关性。此前通过 HTTP 使用 GraphQL 缺乏统一规范,导致与其他 HTTP 工具和可观测性系统的互操作困难。该规范旨在帮助服务器、客户端、代理等组件更好地协同工作。
以下正文由 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 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。