Upstash Ratelimit 滑动窗口时间单位配置指南

在使用 Upstash Ratelimit 实现速率限制功能时，正确配置滑动窗口的时间单位是关键。本文将详细介绍如何正确设置滑动窗口的时间参数，特别是针对一小时时间限制的配置方法。

滑动窗口时间单位的基本语法

Upstash Ratelimit 的滑动窗口时间参数采用简洁的单位表示法，格式为"数值+空格+单位"。支持的时间单位包括：

• ms：毫秒
• s：秒
• m：分钟
• h：小时
• d：天

一小时限制的正确配置

要实现一小时的时间窗口限制，正确的配置方式是使用"1 h"作为时间参数。例如：

const ratelimit = new Ratelimit({
  redis: Redis.fromEnv(),
  limiter: Ratelimit.slidingWindow(2, "1 h")
});

常见错误配置

开发者可能会尝试以下错误配置方式：

1. 使用秒数表示一小时（如"3600 s"）
2. 忘记在数值和单位间加空格
3. 使用不支持的缩写（如"hr"代替"h"）

虽然某些情况下使用秒数表示也能工作，但建议使用标准单位表示法，这样代码更易读且符合API设计规范。

最佳实践建议

1. 优先使用标准单位（h/m/s）而非大秒数
2. 保持数值和单位间的空格
3. 对于复杂的时间限制，考虑使用更易读的组合（如"1 h 30 m"而非"5400 s"）
4. 在团队项目中统一时间单位的表示方式

正确配置时间参数不仅能确保速率限制功能正常工作，还能提高代码的可维护性和可读性。