如何用Node.js构建一个GraphQL API服务器？-js教程-PHP中文网

如何用Node.js构建一个GraphQL API服务器？

betcha

发布： 2025-10-04 08:29:02

原创

592人浏览过

使用 Apollo Server 可快速构建 Node.js GraphQL 服务器，先初始化项目并安装 express、apollo-server-express 和 graphql 依赖，接着定义 User 类型和查询的 schema，编写返回模拟数据的解析器，然后在 Express 应用中启动 Apollo Server 并监听端口，最后通过访问 /graphql 在 Playground 测试 users 和 user 查询，逐步可扩展功能至生产环境。

如何用node.js构建一个graphql api服务器？

构建一个基于 Node.js 的 GraphQL API 服务器并不复杂。你可以使用 Express 搭配 graphql 和 express-graphql 来快速搭建，或者选择更现代的方案如 Apollo Server。下面以 Apollo Server 为例，一步步带你实现。

初始化项目

创建项目目录并初始化 npm：

mkdir my-graphql-server
cd my-graphql-server
npm init -y

安装必要的依赖：

npm install express apollo-server-express graphql

定义 GraphQL Schema 和解析器

创建一个简单的用户查询示例。新建 index.js 文件：

先定义 schema（类型系统）：

const { ApolloServer, gql } = require('apollo-server-express');

// 定义 GraphQL 类型
const typeDefs = gql`
type User {
id: ID!
name: String!
email: String!
}

type Query {
users: [User]
user(id: ID!): User
}
`;

然后编写解析器逻辑：

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

查看详情

// 模拟数据
const users = [
{ id: '1', name: 'Alice', email: 'alice@example.com' },
{ id: '2', name: 'Bob', email: 'bob@example.com' }
];

const resolvers = {
Query: {
users: () => users,
user: (parent, { id }) => users.find(u => u.id === id)
}
};

启动服务器

继续在 index.js 中集成 Express 与 Apollo Server：

const express = require('express');
const { ApolloServer } = require('apollo-server-express');

async function startServer() {
const app = express();

const server = new ApolloServer({ typeDefs, resolvers });
await server.start();
server.applyMiddleware({ app });

const PORT = process.env.PORT || 4000;
app.listen(PORT, () => {
console.log(`? Server ready at http://localhost:${PORT}${server.graphqlPath}`);
});
}

startServer();

运行服务：

node index.js

打开浏览器访问 http://localhost:4000/graphql，即可使用 GraphQL Playground 测试接口。