使用Node.js和Apollo Server搭建GraphQL API，相比REST更高效精准。2. 初始化项目并安装apollo-server-express等依赖。3. 创建服务器实例，定义typeDefs和resolvers。4. 通过gql定义Schema，包括Query和Mutation类型。5. 实现解析器逻辑处理数据请求。6. 集成数据库如Mongoose进行持久化操作。7. 使用Apollo内置错误类统一异常处理。8. 开发时启用GraphQL Playground调试。9. 结合Express中间件实现JWT认证，通过context传递用户信息。
JavaScript 中开发 GraphQL API，核心是使用 Node.js 搭配 GraphQL.js 或更流行的 Apollo Server 来构建服务端接口。相比传统 REST，GraphQL 让客户端精准请求所需数据，减少冗余传输，提升前后端协作效率。
搭建 Apollo Server 基础服务
Apollo Server 是目前最主流的 GraphQL 服务器实现，集成简单，调试友好。
- 初始化项目：
npm init -y，然后安装依赖：npm install apollo-server-express express graphql - 创建基本服务器：
```javascript
const { ApolloServer } = require('apollo-server-express');
const { typeDefs } = require('./schema'); // GraphQL 类型定义
const { resolvers } = require('./resolvers'); // 解析器逻辑
const express = require('express');
async function startServer() {
const app = express();
const server = new ApolloServer({
typeDefs,
resolvers,
});
await server.start();
server.applyMiddleware({ app });
app.listen(4000, () => {
console.log('? GraphQL 服务运行在 http://localhost:4000/graphql');
});
}
startServer();
```
定义 Schema 与解析器
GraphQL 的核心是 schema（模式）和 resolver（解析函数），前者描述数据结构，后者处理数据获取逻辑。
立即学习“Java免费学习笔记（深入）”；
- Schema（typeDefs） 使用 GraphQL SDL（Schema Definition Language）定义类型：
```javascript
const { gql } = require('apollo-server-express');
const typeDefs = gql`
type User {
id: ID!
name: String!
email: String!
}
type Query {
users: [User]!
user(id: ID!): User
}
type Mutation {
createUser(name: String!, email: String!): User!
}
`;
```
- Resolvers 实现查询和变更逻辑：
```javascript
const users = [];
const resolvers = {
Query: {
users: () => users,
user: (parent, { id }) => users.find(u => u.id === id)
},
Mutation: {
createUser: (parent, { name, email }) => {
const user = { id: String(users.length + 1), name, email };
users.push(user);
return user;
}
}
};
```
集成数据库与错误处理
实际项目中，resolver 通常调用数据库或外部 API。可结合 MongoDB（Mongoose）、Prisma 或 Sequelize 等 ORM 工具。
- 在 resolver 中调用数据库操作，例如使用 Mongoose 查询用户
- 统一错误处理：Apollo 提供
UserInputError、AuthenticationError等内置异常类，便于返回结构化错误信息 - 启用调试模式：开发时开启 Playground，生产环境可关闭
添加中间件与认证
利用 Express 中间件机制，轻松集成 JWT 鉴权、日志、限流等功能。
- 在 ApolloServer 配置中通过
context注入用户信息：
```javascript
const server = new ApolloServer({
typeDefs,
resolvers,
context: ({ req }) => {
const token = req.headers.authorization || '';
try {
const user = verifyToken(token); // 解析 JWT
return { user };
} catch (err) {
throw new AuthenticationError('无效或过期的令牌');
}
}
```
resolver 中即可通过 context.user 获取当前用户。
基本上就这些。搭建一个功能完整的 GraphQL API，关键在于清晰的 schema 设计、合理的 resolver 分层以及安全的上下文控制。Apollo 生态提供了丰富工具支持，让 JavaScript 开发者能快速上手并维护高质量接口。
