Fastify路由级限流在PM2集群模式+Redis环境下失效问题排查

以下是几个排查和修复的关键点：

1. 修复Redis客户端连接问题 #

新版Redis客户端（v4+）需要**显式调用connect()**才能建立连接，你的代码里缺少这一步，导致限流插件无法使用Redis存储，退回到进程内存存储——而PM2集群模式下每个进程的内存独立，自然无法跨进程共享限流计数。

修改后的配置代码：

const { createClient } = require('redis');

// 创建Redis客户端并处理连接
const redisClient = createClient("redis://redis_url");
redisClient.on('error', err => console.error('Redis连接异常:', err));
await redisClient.connect(); // 确保在注册插件前完成连接，需放在async函数中

fastify.register(require('@fastify/rate-limit'), {
  global: false,
  redis: redisClient
});

可以通过添加以下代码验证连接是否成功：

// 连接成功后测试
redisClient.connect().then(() => {
  return redisClient.ping();
}).then(pong => {
  console.log('Redis连接正常:', pong); // 输出PONG则连接成功
}).catch(err => {
  console.error('Redis连接失败:', err);
});

2. 确认PM2集群进程能访问Redis #

确保所有PM2启动的Fastify进程都能连接到同一个Redis实例：

• 检查Redis地址redis_url是否正确（比如是否是内网IP、端口是否开放）
• 排查防火墙/安全组是否允许Fastify进程访问Redis端口
• 如果Redis设置了密码，需要在连接URL中带上：redis://:password@redis_url:port

3. 配置正确的客户端IP标识 #

如果你的服务前面有反向代理（比如Nginx），Fastify默认会拿到代理服务器的IP而非真实客户端IP，导致限流key错误。需要在Fastify实例初始化时开启trustProxy：

const fastify = require('fastify')({
  trustProxy: true // 信任代理服务器，获取真实客户端IP
});

4. 简化限流参数测试 #

尝试将timeWindow改为数字格式（毫秒），避免字符串解析异常：

fastify.get('/hello',{
  config: {
    rateLimit: {
      max: 1,
      timeWindow: 60000 // 1分钟=60000毫秒
    }
  }
}, async (req, reply) => {
  reply.send("world")
})

5. 验证版本兼容性 #

确保@fastify/rate-limit版本与Redis客户端版本兼容：

• @fastify/rate-limit v8+ 适配Redis客户端v4+
• 如果使用Redis客户端v3及以下，需要降级@fastify/rate-limit到v7版本

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