BITFIELD比SETBIT更适合多状态打卡,因其支持在同一key中按位划分多个字段(如连续天数、补签标记、积分、封禁状态),一条命令原子完成读、写、自增操作,避免多命令并发覆盖问题。

BITFIELD 为什么比 SETBIT 更适合多状态打卡
因为打卡场景里,用户状态从来不是单个“是否签到”,而是多个关联字段:是否补签、连续天数、积分余额、等级、封禁标记……用 SETBIT 只能存 0/1,每次改一个字段都要发多条命令,中间可能被其他客户端覆盖。而 BITFIELD 允许你在同一 key 的不同位偏移上,定义多个字段(比如用前 5 位存连续天数,第 6 位存补签标记,第 7–15 位存积分),一条命令完成读+写+自增,全程原子执行。
如何用 BITFIELD 定义打卡状态字段布局
关键在字段宽度和起始偏移的规划。例如一个用户当月打卡状态可设计为:
-
u5 0:连续签到天数(0–31,5 位足够) -
i1 5:补签标记(1 位有符号整数,-1/0/1 不实用,实际用u1 5表示 0/1 更稳妥) -
u16 6:当日积分(0–65535,16 位) -
u1 22:是否封禁(1 位)
注意:所有偏移单位是 bit,不是 byte;字段不能跨字节对齐,但 Redis 会自动处理内存布局。别把偏移算错——比如 u16 6 占用第 6~21 位,下一个字段必须从 22 开始。
用一条 BITFIELD 命令完成签到+连续天数更新
典型操作是:今天签到了,连续天数 +1;如果昨天没签,则重置为 1。这需要先读旧值,再决定怎么写,BITFIELD 支持链式操作,无需 Lua 就能原子完成:
BITFIELD sign:1001:202610 \ GET u5 0 \ SET u5 0 1 \ INCRBY u5 0 1
上面命令会返回三元数组:[旧连续天数, 旧值(被设为 1), 新连续天数]。但要注意:INCRBY 在值为 0 时加 1 得 1,符合“首次签到”逻辑;若需“断签重置”,就得靠客户端判断返回值后分两步走——先 GET,再根据结果选 SET 或 INCRBY,此时必须包进 Lua 脚本才能保证原子性。
容易踩的坑:溢出、符号位、客户端兼容性
BITFIELD 默认溢出行为是 WRAP(回绕),比如 u5 0 当前是 31,再 INCRBY u5 0 1 会变成 0。这通常不是你想要的,应显式指定 OVERFLOW SAT(饱和截断):
BITFIELD sign:1001:202610 OVERFLOW SAT \ INCRBY u5 0 1
另外,i8 和 u8 读同一段内存结果不同——带符号类型会把最高位当符号位,误判负数;打卡状态建议全用 u 前缀。最后,部分老版本 Redis 客户端(如 Jedis 3.x)不支持 BITFIELD 返回数组解析,会抛 ClassCastException,务必升级到 Jedis 4.0+ 或用 Lettuce。
字段宽度和偏移一旦定死就不能动态调整,改结构等于重刷全量数据。上线前一定用真实数据压测边界值,比如连续天数冲到 31 后再签一次,看溢出策略是否生效。


















