当前位置：首页 > 文章列表 > 文章 > 前端 > GraphQL是什么？怎么替代RESTAPI？

GraphQL是什么？怎么替代RESTAPI？

2025-12-31 08:21:40 0浏览收藏

最近发现不少小伙伴都对文章很感兴趣，所以今天继续给大家介绍文章相关的知识，本文《GraphQL是什么？如何替代REST API？》主要内容涉及到等等知识点，希望能帮到你！当然如果阅读本文时存在不同想法，可以在评论中表达，但是请勿使用过激的措辞~

GraphQL是一种用于API的查询语言和运行时规范，非JavaScript原生部分，不替代REST但提供更灵活高效的数据获取方式，支持客户端精确指定字段、多资源聚合及强类型schema。

javascript中的GraphQL是什么_如何用它替代REST API

GraphQL 不是 JavaScript 的一部分，而是一种用于 API 的查询语言和运行时，它可以用 JavaScript（比如在 Node.js 环境中）实现服务端和客户端交互。它不替代 REST，而是提供一种更灵活、更高效的数据获取方式——尤其适合前端需要精确控制返回字段、多资源聚合、或避免多次请求的场景。

GraphQL 是什么：不是协议，是规范

GraphQL 是一套开放规范，定义了客户端如何声明所需数据结构，服务端如何按需响应。它不依赖 HTTP 方法（GET/POST），但通常通过一个 HTTP POST 请求发送查询字符串到单一 endpoint（如 /graphql）。服务端需实现 GraphQL 执行器（如用 graphql-js 库），并定义 schema（类型系统）、resolver（数据获取逻辑）。

关键特点：

客户端决定要什么字段，服务端不预设响应结构
单次请求可获取多个关联资源（比如用户 + 他的帖子 + 每篇帖子的评论）
强类型 schema 提供自动文档、IDE 提示和校验能力
无内置分页、授权、缓存机制，需手动设计或借助工具（如 Apollo Server 插件）

怎么用 JavaScript 实现一个简单 GraphQL 服务

以 Node.js + Express 为例，用 graphql 和 express-graphql 快速搭建：

安装依赖：npm install graphql express-graphql express

定义 schema（用 GraphQL Schema Definition Language）：

<code type="javascript">const { buildSchema } = require('graphql');
const schema = buildSchema(`
  type User {
    id: ID!
    name: String
    email: String
  }
  type Query {
    user(id: ID!): User
  }
`);</code>

编写 resolver（告诉每个字段怎么取数据）：

<code type="javascript">const root = {
  user: ({ id }) => {
    // 模拟数据库查找
    return { id, name: '张三', email: 'zhang@example.com' };
  }
};</code>

挂载 GraphQL 中间件：

<code type="javascript">const express = require('express');
const { graphqlHTTP } = require('express-graphql');

const app = express();
app.use('/graphql', graphqlHTTP({ schema, rootValue: root, graphiql: true }));
app.listen(4000);</code>

启动后访问 http://localhost:4000/graphql 就能用 GraphiQL 调试界面写查询，例如：

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

如何在前端用 JavaScript 调用 GraphQL

不用框架也能调，核心就是发一个带 query 字符串的 POST 请求：

原生 fetch 示例：

<code type="javascript">fetch('/graphql', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    query: `query GetUser($id: ID!) { user(id: $id) { name email } }`,
    variables: { id: '1' }
  })
})
.then(res => res.json())
.then(data => console.log(data.data.user));</code>