Next.js+React Apollo多pm2集群实例Apollo Client缓存同步问题

问题本质 #

PM2集群模式下的每个Node.js实例都是独立进程，各自维护专属的Apollo Client内存缓存（InMemoryCache）。用户请求会被负载均衡分配到不同实例，切换用户后如果命中缓存未更新的实例，就会显示上一用户的旧数据。

可行解决方案 #

1. 服务端请求创建独立Client实例（快速解决） #

如果你的应用不需要服务端缓存复用，直接为每个用户请求创建独立的Apollo Client实例，从根源避免跨实例缓存污染：

// 封装Client创建函数
const createApolloClient = () => {
  return new ApolloClient({
    link: splitLink,
    cache: new InMemoryCache(),
    ssrMode: true,
  });
};

// 在getServerSideProps/API路由中每次调用都生成新实例
export async function getServerSideProps(context) {
  const client = createApolloClient();
  // 业务请求逻辑
}

每个请求的缓存完全隔离，不会出现跨用户、跨实例的缓存残留问题。

2. 改用共享缓存存储（适合需服务端缓存优化场景） #

如果需要服务端缓存提升性能，将Apollo缓存从本地内存转移到Redis等共享存储，让所有集群实例共用同一缓存源：

步骤1：安装依赖

npm install apollo-server-cache-redis ioredis

步骤2：替换缓存配置

import { RedisCache } from 'apollo-server-cache-redis';
import Redis from 'ioredis';
import { ApolloClient } from '@apollo/client';

// 连接Redis服务
const redisClient = new Redis({
  host: '你的Redis地址',
  port: 6379,
  // 按需添加密码、数据库编号等配置
});

// 创建共享缓存实例
const sharedCache = new RedisCache({ redis: redisClient });

// 初始化Apollo Client
const client = new ApolloClient({
  link: splitLink,
  cache: sharedCache, // 替换为Redis共享缓存
  ssrMode: true,
});

客户端仍可保留InMemoryCache保证前端体验，服务端用共享缓存解决跨实例同步问题。

3. 用户切换时主动清理缓存（补充防护） #

在用户切换账号时，主动清理当前实例缓存，并通过PM2进程间通信通知其他实例同步清理：

客户端清理缓存

// 用户登出/切换账号时执行
client.resetStore();
// 或针对特定数据类型精准清理
client.cache.evict({ fieldName: 'posts' });
client.cache.gc();

跨实例同步清理

利用PM2的IPC广播功能，让所有实例同步清理缓存：

// 服务端监听IPC消息
process.on('message', (msg) => {
  if (msg.type === 'CLEAR_APOLLO_CACHE') {
    client.cache.reset();
  }
});

// 需要清理时，发送广播消息
if (process.send) {
  process.send({
    type: 'pm2:broadcast',
    data: { type: 'CLEAR_APOLLO_CACHE' },
  });
}

额外注意事项 #

• 缓存键要包含用户身份标识（比如用户ID），避免不同用户的数据在缓存中混淆。
• 敏感用户数据尽量只在客户端缓存，服务端避免缓存这类数据，减少泄露风险。

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