Next.js中Apollo Server v3迁移至v4：createHandler替代方案问询

Apollo Server v4 已移除 createHandler 方法，官方推荐使用 @as-integrations/next 库提供的 startServerAndCreateNextHandler 作为等效替代方案，以下是完整解决步骤：

1. 安装依赖 #

首先安装官方维护的 Next.js 集成库，执行对应包管理器命令：

# npm
npm install @as-integrations/next

# yarn
yarn add @as-integrations/next

# pnpm
pnpm add @as-integrations/next

如果安装失败，可尝试清除包管理器缓存后重试（如 npm cache clean --force），同时确保 Node.js 版本 ≥16（Apollo Server v4 最低要求）。

2. 替换原有代码 #

将你原来的 API 路由代码（如 pages/api/graphql.js 或 app/api/graphql/route.js）替换为以下写法：

import { ApolloServer } from '@apollo/server';
import { startServerAndCreateNextHandler } from '@as-integrations/next';
import { gql } from 'graphql-tag';

// 替换为你自己的 Schema 和 Resolver
const typeDefs = gql`
  type Query {
    hello: String
  }
`;

const resolvers = {
  Query: {
    hello: () => 'Hello from Apollo Server v4!',
  },
};

// 初始化 Apollo Server（v4 标准写法）
const apolloServer = new ApolloServer({ typeDefs, resolvers });

// 导出处理函数，替代原 createHandler 逻辑
export default startServerAndCreateNextHandler(apolloServer, {
  // 可选：传递上下文，可获取 req/res 等请求参数
  context: async (req, res) => ({ req, res }),
});

关键说明 #

• startServerAndCreateNextHandler 内部会自动处理服务器启动流程，无需手动调用 await startServer
• 该方法完全兼容 Next.js 的 API 路由机制，功能上与 v3 的 createHandler 完全等效
• 无论使用 Next.js Pages Router 还是 App Router，写法保持一致，无需额外适配

内容的提问来源于stack exchange，提问作者Michael