Apollo Server Express搭配Redis缓存不生效问题求助

你遇到的问题是Apollo Server响应缓存未生效，核心原因通常是缺失必要配置或依赖兼容问题，按以下步骤修复即可：

1. 补全响应缓存插件配置 #

Apollo Server 3.x及以上版本，仅配置cache和cacheControl参数不会自动启用响应缓存，必须显式注册responseCachePlugin插件：
首先安装对应依赖：

npm install @apollo/server-plugin-response-cache

修改server.js中的ApolloServer配置：

// 顶部引入插件
const responseCachePlugin = require('@apollo/server-plugin-response-cache');

const apolloServer = new ApolloServer({
  typeDefs,
  resolvers,
  cache: new BaseRedisCache({
    client: redisClient
  }),
  cacheControl: true,
  plugins: [responseCachePlugin()], // 新增插件配置
});

2. 修复Redis客户端兼容问题 #

如果你使用的是redis@4.x（当前npm默认最新版），旧版配置逻辑已不兼容，会导致Redis连接异常无法写入缓存：
修改cacheClient.js代码：

require('dotenv').config();

const { REDIS_SERVER, REDIS_PORT } = process.env;
const redis = require('redis');

const client = redis.createClient({
  // v4版本要求用socket字段包裹连接配置
  socket: {
    host: REDIS_SERVER,
    port: REDIS_PORT,
  }
});

// v4版本需要手动触发连接
client.connect().catch(err => console.error('Redis连接失败：', err));

client.on('connect', () => {
  console.log('Redis client connected');
});
// 新增错误监听，方便排查连接问题
client.on('error', (err) => {
  console.error('Redis运行错误：', err);
});

module.exports = client;

如果你使用的是redis@3.x版本，可跳过配置修改，但建议添加错误监听逻辑排查连接问题。

3. 修正缓存作用域配置 #

如果你的getUserProfile是用户私有接口（不同用户返回内容不同），需要在设置cacheHint时指定私有作用域，避免缓存跨用户共享或被判定为不可缓存：

const getUserProfile = async (_, args, context, info) => {
  info.cacheControl.setCacheHint({ maxAge: 300, scope: 'PRIVATE' });
  console.log('MISS, set cache hint')
  return context;
};

如果是公共内容，将scope设为PUBLIC即可。

4. 其他可选排查点 #

• 确认当前操作是Query类型，Mutation操作默认不会被缓存
• 可在ApolloServer配置中添加debug: true，控制台会输出详细的缓存命中/失效日志，方便定位特殊问题
• 检查Schema中子字段是否配置了@cacheControl(maxAge: 0)，子字段的零缓存配置会覆盖上层的maxAge设置
• 确认resolver返回的内容可被JSON序列化，不可序列化的内容会导致缓存写入失败

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