使用rate-limiter-flexible遇Lua Redis参数错误求助

问题原因 #

出现该错误主要有两个核心诱因：

1. Redis客户端版本与rate-limiter-flexible适配异常，尤其是使用redis@4.x版本时未正确初始化连接或配置参数格式错误
2. 请求key中包含特殊字符（如IPv6地址的::），导致Lua脚本解析参数时类型识别异常

解决方案 #

方案1：修正Redis客户端初始化与连接逻辑 #

若使用redis@4.x及以上版本，需调整客户端配置格式并显式建立连接：

const redis = require('redis');
const { RateLimiterRedis } = require('rate-limiter-flexible');

// 创建Redis客户端，采用url格式配置（替代原host+port拆分写法）
const redisClient = redis.createClient({
  url: 'redis://localhost:6379'
});

// 监听连接错误
redisClient.on('error', (err) => console.log('Redis Client Error', err));
// 显式建立连接（async函数内可直接await，外部可改用then链式调用）
await redisClient.connect();

// 后续限流配置与中间件代码保持不变

方案2：对请求key进行URL编码 #

将key中的特殊字符编码，避免Lua脚本解析异常：

const rateLimitMiddleware = async (req, res, next) => {
  const ip = req.connection.remoteAddress;
  const url = req.originalUrl;
  // 对url和ip中的特殊字符进行编码
  const encodedUrl = encodeURIComponent(url);
  const encodedIp = encodeURIComponent(ip);
  const key = `${encodedUrl}_${encodedIp}`;
  
  try {
    const rateLimiterRes = await rateLimiter.consume(key);
    next();
  } catch (rejRes) {
    const remainingTime = Math.ceil(rejRes.msBeforeNext / 1000);
    // 补充限流后的响应逻辑示例
    res.status(429).json({
      message: '请求过于频繁，请稍后再试',
      retryAfter: remainingTime
    });
  }
};

方案3：降级Redis客户端版本 #

若上述方案无效，可尝试将Redis客户端降级至v3.x版本，此时无需显式调用connect()，原host+port配置格式可正常使用：

npm uninstall redis
npm install redis@3.1.2

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