Redis TIME命令返回时间戳跳变异常问题咨询

问题描述 #

运行以下脚本时，Redis TIME命令返回的时间戳频繁出现大幅向前跳变后又回退的规律现象，导致滑动窗口限流器异常。需明确该现象的原因及相关官方说明。

测试脚本 #

res_0, res_1 = 0, 0
for _ in range(200):
    script = f"""
        local time = redis.call("TIME")
        local current_time = time[1] .. "." .. time[2]
        return current_time
    """
    res_0 = res_1
    res_1 = float(await redis.eval(script, numkeys=0))
    print(res_1 - res_0)
    time.sleep(0.01)

输出结果 #

1667745169.747809
0.011765003204345703
0.01197195053100586
0.011564016342163086
0.011634111404418945
0.012428998947143555
0.011847972869873047
0.011600971221923828
0.011788129806518555
0.012033939361572266
0.012130022048950195
0.01160883903503418
0.011954069137573242
0.012022972106933594
0.011958122253417969
0.011713981628417969
0.011844873428344727
0.012138128280639648
0.011618852615356445
0.011570215225219727
0.011890888214111328
0.011478900909423828
0.7928261756896973
-0.5926899909973145
0.11812996864318848
0.11584997177124023
0.12353992462158203
0.1199800968170166
0.11719989776611328
0.12331008911132812
-0.8117339611053467
0.011723995208740234
0.01131582260131836

原因分析 #

1. 多实例/集群节点时间不同步 #

如果Redis是集群部署、哨兵模式或使用多实例连接池，客户端请求可能被路由到不同节点。若各节点系统时间存在偏差，就会出现TIME返回值跳变回退：请求切换到时间更快的节点时，时间戳向前跳；切回原节点时，时间戳回退。

2. 系统时间被强制调整 #

TIME命令返回的是Redis所在主机的系统时间，若主机使用的NTP服务（如ntpdate）发现时间偏差过大，会直接强制跳变系统时间而非平滑调整。这种情况下，TIME返回值会突然跳变，后续NTP再次修正时就会出现回退。

3. 浮点数精度丢失问题 #

脚本中将秒和微秒拼接成字符串再转浮点数的操作，可能因浮点数精度限制导致时间表示失真。当微秒部分数值较大时，浮点数无法精确存储，会放大时间差的表现。

官方文档相关说明 #

Redis官方文档对TIME命令的明确说明：

• TIME返回服务器主机的当前系统时间，由秒级整数和微秒级整数两部分组成，完全依赖于系统时间。
• 若系统时间被外部工具（如NTP）修改，TIME的返回值会随之变化。
• 在集群环境中，所有节点必须保持系统时间同步，否则会导致依赖时间的命令（如滑动窗口限流）出现异常。

解决方案 #

• 同步多实例时间：若为集群/多实例部署，使用NTP服务将所有节点系统时间同步到同一基准，偏差控制在毫秒级以内。
• 改用整数计算时间：在Lua脚本中直接将时间转换为微秒级整数（time[1] * 1000000 + time[2]），避免浮点数精度丢失，用整数计算时间差更准确。
• 配置平滑时间同步：将主机时间同步工具从ntpdate改为ntpd或chronyd，这类工具会平滑调整时间，避免强制跳变。

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