服务端库

这一课你将能做到

1. 用 graphql-js / Apollo Server / Yoga 任选一个跑通最小可运行服务
2. 说出 Java 生态（Spring for GraphQL）与 Node 生态的对应能力栈
3. 为项目选型时讲清「底层引擎 / 全家桶 / 现代轻量」三个维度的权衡

为什么要学

GraphQL 是规范不是实现。学完语言与执行模型，你必须知道主流服务端库的能力差异：谁自带 IDE、谁支持文件上传、谁跟进了 graphql-ws 新协议、谁和 Spring 生态原生集成。选错库的代价不是跑不起来，而是两年后被版本锁定拖住、迁移成本高昂。

人话：库就是施工队——有的只砌墙（引擎），有的自带家具（全家桶），有的连物业都包了（框架集成）——看你要盖什么房。

先建立图像

选型决策树：

想手写每一步、理解引擎原理？      → graphql-js（Node）/ graphql-java（JVM）
想要开箱即用、生态最丰富？        → Apollo Server（Node）
想要现代协议 + 最小依赖？         → GraphQL Yoga / Pothos（Node）
团队在 Spring Boot 技术栈里？     → Spring for GraphQL（官方出品）

Node 生态主要库一览：

库	定位	特点
graphql-js	核心引擎	解析 + 校验 + 执行，不含 HTTP 层
apollo-server	全功能服务器	IDE/插件/指标齐全，生态最大，体积最大
graphql-yoga	轻量现代服务器	graphql-ws/SSE/上传/新 HTTP 规范全内置
pothos	Code-first 构建器	从 TS 类型生成 Schema
type-graphql	Code-first 装饰器	类 + 装饰器写 Schema

跟着做

步骤 1：graphql-js 手写最小引擎（理解原理）

npm install graphql

const { buildSchema, graphqlSync } = require('graphql')

const schema = buildSchema(`type Query { ping: String }`)
const root = { ping: () => 'pong' }

const result = graphqlSync({ schema, source: '{ ping }', rootValue: root })
console.log(result)   // { data: { ping: 'pong' } }

graphql-js 提供 AST 解析、Schema 构建、执行引擎，但不提供 HTTP 路由、WebSocket、IDE。它适合自定义网关/胶水层，不适合直接扛生产流量。

步骤 2：Apollo Server 最小服务

npm install @apollo/server graphql

import { ApolloServer } from '@apollo/server'
import { startStandaloneServer } from '@apollo/server/standalone'

const typeDefs = `#graphql
  type Query { lesson(slug: String!): Lesson }
  type Lesson { id: ID! title: String! }
`
const resolvers = {
  Query: { lesson: (_p, { slug }) => ({ id: slug, title: '样例课时' }) }
}

const server = new ApolloServer({ typeDefs, resolvers })
const { url } = await startStandaloneServer(server, { listen: { port: 4000 } })
console.log(url)   // 自带 Apollo Sandbox IDE