NestJS代码优先模式配置Apollo cacheControl缓存不生效问题

你当前仅完成了@cacheControl指令的Schema层面声明，缺少Apollo缓存逻辑的核心接入步骤，指令本身只是元数据标记，不会自动触发缓存逻辑，缺失的关键配置如下：

• 移除冗余的手动指令声明
  你在buildSchemaOptions.directives中手写的cacheControl指令定义完全多余，Apollo官方缓存插件会自动向Schema注入标准的@cacheControl指令和对应枚举，手动声明反而可能出现参数不匹配、元数据解析异常的问题，直接删除这部分配置即可。
• 接入Apollo缓存控制核心插件
  安装和项目内@apollo/server/apollo-server-core版本匹配的依赖后，在GraphQLModule配置中注册插件，开启响应头自动计算：

  import { ApolloServerPluginCacheControl } from '@apollo/server/plugin/cacheControl';
  // Apollo Server v3版本请从'apollo-server-core'引入该插件
  
  GraphQLModule.forRootAsync({
    driver: ApolloDriver,
    useFactory: () => ({
      // 原有其他配置（比如playground、上下文配置等）保持不变
      plugins: [
        ApolloServerPluginCacheControl({
          defaultMaxAge: 0, // 默认策略为不缓存，和现有逻辑兼容
          calculateHttpHeaders: true, // 核心开关：遍历Schema指令元数据，自动计算并返回Cache-Control响应头
        })
      ],
    })
  })
  

• 补全查询入口字段的缓存规则
  Apollo缓存策略的计算逻辑是取当前查询涉及所有字段的最小maxAge值，你目前只给User类型的子字段加了maxAge:60，如果查询入口（比如获取用户列表的users查询字段）没有加缓存规则，默认maxAge=0，最终响应的Cache-Control头会是max-age=0，等同于不缓存。
  你可以根据需求选择以下任意一种配置方式：
  1. 给查询入口字段加缓存指令：

  @Query(() => [User])
  @Directive('@cacheControl(maxAge: 60)')
  async getUsers() {
    return this.userService.findAll()
  }
  

  2. 直接给整个User类型加缓存规则，无需给每个字段单独配置：

  @ObjectType('User')
  @Directive('@cacheControl(maxAge: 60)')
  export class User {
    @Field(() => Int)
    id!: number
  
    @Field()
    text!: string
  }
  

• （可选）开启服务端全响应缓存
  上述配置完成后，只会在响应头中返回Cache-Control规则，供浏览器、CDN等下游节点做缓存，服务端本身不会缓存解析结果，每次请求依然会执行你的业务查询逻辑。如果需要服务端直接返回缓存结果、跳过解析器执行，需要额外注册响应缓存插件，搭配缓存存储使用：

  import { ApolloServerPluginResponseCache } from '@apollo/server/plugin/responseCache';
  import { KeyvAdapter } from '@apollo/utils.keyvadapter';
  import Keyv from 'keyv';
  
  // 在plugins数组中追加
  ApolloServerPluginResponseCache({
    cache: new KeyvAdapter(new Keyv()), // 可替换为Redis等持久化缓存存储，默认用内存存储
  })
  

注意：如果字段标记为scope: PRIVATE，缓存策略会单独针对单用户生效，不会在多用户间共享缓存结果。

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