迁移Apollo Server 4后请求报错：Cannot read properties of undefined (reading 'method')

可能原因及解决方案 #

1. 检查Lambda请求处理的适配代码 #

AWS Lambda的请求对象格式与Apollo Server默认期望的HTTP请求格式存在差异，需确保集成层正确转换请求。如果是手动编写Lambda handler，确认是否正确使用startServerAndCreateLambdaHandler或createLambdaHandler：

import { ApolloServer } from '@apollo/server';
import { startServerAndCreateLambdaHandler } from '@as-integrations/aws-lambda';
import { schema } from './schema';

const server = new ApolloServer({ schema });

export const handler = startServerAndCreateLambdaHandler(
  server,
  // 根据API网关类型选择适配逻辑，比如APIGatewayV2Request或APIGatewayRequest
  {
    requestHeaders: (event) => event.headers,
    requestHttpMethod: (event) => event.httpMethod,
    requestBody: async (event) => JSON.parse(event.body || '{}'),
  }
);

注意：若使用API Gateway V2（如HTTP API），需对应使用正确的请求解析逻辑；如果是自定义事件源，要手动映射method字段，避免字段缺失。

2. 调整依赖版本兼容性 #

当前graphql@15.8.0是Apollo Server 4支持的最低版本（要求≥15.3.0），但部分场景下可能存在适配问题，可尝试升级graphql到16.x稳定版本：

npm install graphql@^16.6.0

3. 排查请求对象字段丢失问题 #

如果自定义封装了Lambda handler，检查是否有中间件修改event对象导致httpMethod或headers字段丢失。可在handler开头添加日志打印event结构，确认关键字段是否存在：

export const handler = async (event) => {
  console.log('Lambda event:', JSON.stringify(event));
  // 后续Apollo处理逻辑
};

若日志显示httpMethod不存在，需检查API Gateway配置或自定义事件的构造逻辑是否正确。

4. 修正Apollo Server初始化配置 #

确保Apollo Server的context函数中没有错误依赖未定义的请求字段，可先做存在性判断：

const server = new ApolloServer({
  schema,
  context: async ({ req }) => {
    if (!req?.method) {
      throw new Error('Request method is undefined');
    }
    // 其他context逻辑
  },
});

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