推荐用 user:login:day:{uid}:YYYYMMDD 格式存储每日登录记录,客户端传入 today_str 和 max_days,Lua 脚本逐日拼 key 并用 EXISTS 判断存在性以统计连续天数。

Redis 本身不支持跨 key 的聚合计算,但用 Lua 脚本能安全、原子地完成连续登录天数统计——关键在于设计合理的 key 结构和日期对齐逻辑。
怎么设计用户登录记录的 key 结构
必须让日期可排序、可推算、且不依赖客户端时间精度。推荐用 user:login:date:{uid} 作为集合(SET)或有序集合(ZSET),但更稳妥的是用 user:login:day:{uid} 存储每天一个 string key,值为 "1",这样能直接用 EXISTS 判断某天是否登录。
- 用
user:login:day:{uid}:20240520这类格式,避免时区/闰秒问题,服务端统一用 UTC+0 或本地午夜截断生成日期字符串 - 不要用
INCR或HINCRBY记录次数——连续性只看“是否存在”,不是“登录几次” - 如果用
ZSET,score 必须是精确到天的时间戳(如1716192000表示 2024-05-20 00:00:00),且插入前需 floor 到当日 0 点
Lua 脚本里怎么判断“连续”
连续 ≠ 总天数,而是从今天起往前数,第一个断掉的日期之前的天数。脚本必须从当前日期开始倒推,逐日检查 key 是否存在,直到遇到缺失或达到上限(比如最多查 365 天)。
- 用
redis.call("EXISTS", key)检查每日 key,比GET更轻量 - 日期递减要手动计算:Lua 没有内置日期函数,得靠
os.time+os.date,但 Redis 默认禁用这些;所以**必须由客户端传入 today_str(如 "20240520")和 max_days(如 100)**,脚本只做字符串解析和拼接 - 示例片段:
local uid = KEYS[1] local today = ARGV[1] -- "20240520" local max_days = tonumber(ARGV[2]) local count = 0 for i = 0, max_days - 1 do local ymd = string.sub(today, 1, 4) .. string.sub(today, 5, 6) .. string.sub(today, 7, 8) -- 实际需写个简单日期减法(如转为数字后减 i*10000?不行,得按年月日进位) -- 更可靠:客户端传入 today_num(20240520)和逐日递减后的 date_num 数组,脚本只拼 key end
为什么不能用 EVALSHA 缓存脚本却忽略 key 数量限制
Redis 要求所有被 Lua 脚本访问的 key 必须显式传入 KEYS 数组,否则在集群模式下会报 CROSSSLOT Keys in request don't hash to the same slot 错误。
- 如果你的脚本动态拼了 30 个日期 key(如
user:login:day:123:20240520到20240421),就必须把这 30 个 key 全部塞进KEYS参数——而 Redis 单次命令的KEYS长度有限制(通常 1024,但实际建议 ≤ 100) - 解决方案:改用单 key 存储多日状态,比如用 bitmap(
SETBIT user:login:bitmap:{uid} offset 1),offset = (today_ts - base_ts) / 86400;这样只需一个 key,但需要客户端算 offset 和 base_ts - 或者接受上限,比如最多查 30 天,就固定传 30 个 key,超出部分由应用层分批查
真正难的不是写 Lua,而是让日期计算不漂移、key 分布不跨槽、以及客户端和服务端对“今天”的定义完全一致——这三个点任何一个出错,连续天数就会突然归零或虚高。


















