Apollo Server 4集成Azure Functions：如何设置响应头与Cookie？

• 确认Apollo Server 4的响应处理逻辑
  Apollo Server 4对响应的处理逻辑和v3存在差异，官方Azure Functions集成包（@apollo/server-integrations/azure-functions）要求通过context传递并操作Azure Functions的原生响应对象，而非直接在Resolver中修改响应。确保创建Apollo Server实例时，正确配置context传递Azure Functions的上下文：

const server = new ApolloServer({
  typeDefs,
  resolvers,
});

export default server.start().then(() => {
  return createHandler({
    server,
    context: async ({ context }) => {
      return { azureContext: context };
    },
  });
});

• 在Resolver中直接操作Azure响应对象
  在Resolver里通过传入的azureContext获取res对象，直接修改响应头或Cookie，不要依赖Apollo Server的formatResponse或响应插件：

const resolvers = {
  Mutation: {
    login: async (_, args, { azureContext }) => {
      // 设置自定义响应头
      azureContext.res.headers.set('X-Custom-Header', 'custom-value');
      // 设置Cookie（严格配置属性避免浏览器拦截）
      azureContext.res.cookies.set('auth-token', 'your-auth-token', {
        httpOnly: true,
        secure: process.env.NODE_ENV === 'production',
        sameSite: 'lax',
        maxAge: 86400,
        path: '/',
      });
      return { success: true };
    },
  },
};

• 验证Cookie属性的合规性
  Apollo Server 4对Cookie的校验更严格，需确保配置符合浏览器安全规范：

  • 生产环境必须设置secure: true（仅HTTPS环境生效）
  • sameSite设为none时必须搭配secure: true
  • domain需匹配当前服务域名，避免跨域Cookie被拦截

• 检查CORS配置一致性
  若前端与API跨域，需同时配置Apollo Server和Azure Functions的CORS规则：

// Apollo Server的CORS配置
return createHandler({
  server,
  context: async ({ context }) => ({ azureContext: context }),
  cors: {
    origin: process.env.FRONTEND_ORIGIN,
    credentials: true,
  },
});

同时在Azure Portal的Functions配置中，将前端域名加入CORS允许列表，并启用「允许凭据」选项。

• 调试响应流程
  添加日志确认响应头/Cookie是否被正确设置：

// 在Resolver中打印日志
console.log('当前响应头:', azureContext.res.headers);
console.log('已设置Cookie:', azureContext.res.cookies);

通过Azure Functions的日志面板，追踪请求处理全流程，确认响应头是否成功传递到客户端。

• 更新集成包版本
  确保使用的@apollo/server-integrations/azure-functions为最新版本，旧版本可能存在响应处理的兼容bug，执行命令更新：

npm update @apollo/server-integrations/azure-functions

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