Bitmaps本质是字符串，Redis的位操作命令作用于string类型的二进制位；不可跨数据类型操作，需规范命名、初始化、避免混用命令，并合理分片控制内存与性能。
Bitmaps 本质是字符串，不是独立数据类型
Redis 的 SETBIT、GETBIT、BITCOUNT 等命令操作的其实是 string 类型的底层二进制位。这意味着：你不能对一个已存为 hash 或 zset 的 key 执行 SETBIT，会报错 WRONGTYPE Operation against a key holding the wrong kind of value；也别指望用 KEYS 直接扫出“所有 Bitmap”，它们和普通字符串完全无法区分。
实操建议：
- 约定 key 命名规范，比如
sign:202405:user:{uid}，避免和其他 string 混淆 - 首次写入必须用
SETBIT或SET初始化（SET sign:202405:user:123 \x00再SETBIT也行），空 key 直接GETBIT返回 0，但BITCOUNT对不存在的 key 返回 0 —— 这点容易误判“没人签到” - 不要在同一个 key 上混用
APPEND或INCR，会破坏位布局
单日签到用 SETBIT + 用户 ID 偏移，不是时间戳
把用户 ID 当作 bit 偏移量最省空间，但前提是用户 ID 是连续或接近连续的整数（如自增主键）。例如用户 ID=1001，想标记其在 2024-05-01 签到，就执行：
SETBIT sign:20240501 1001 1而不是用时间戳做 offset（
SETBIT sign:uid:123 1714521600 1）——后者会导致位图极度稀疏，内存暴增。
常见错误现象：
- 用毫秒时间戳当 offset，一个 key 动辄占用几百 MB，
BITCOUNT变得极慢 - 用户 ID 是字符串（如 UUID），强行转成 int 导致溢出或冲突，应改用布隆过滤器或分片 hash（见下一条）
- 没控制 offset 上限，
SETBIT sign:20240501 999999999 1会分配近 120MB 内存，即使只设了 1 个 bit
超大用户量需分片：按用户 ID 取模 or 时间维度拆 key
单个 Bitmap 最好控制在几 MB 内。若用户 ID 范围大且稀疏（比如最大 ID 是 2 亿，但只有 50 万活跃用户），直接用 ID 做 offset 不现实。这时有两种主流分片方式：
-
按 UID 取模分片：比如
sign:20240501:0存 UID % 100 == 0 的用户，sign:20240501:1存 % 100 == 1 的……查某用户时先算uid % 100得到分片号，再GETBIT对应 key。缺点是聚合统计（如当日总签到人数）要BITCOUNT100 个 key 并累加 -
按时间+用户范围分片：如
sign:20240501:0_99999、sign:20240501:100000_199999，适合后台批处理场景，但需要维护用户 ID 区间映射表
性能提示：分片越多，BITCOUNT 聚合越慢；但单 key 越小，内存碎片和网络序列化开销越低。通常 16–64 分片是较稳的选择。
BITFIELD 能原子读写多天，但要注意 overflow 行为
如果要查用户「连续签到天数」，得读连续多天的 bit。用多次 GETBIT 不仅慢，还无法保证原子性。BITFIELD 可以一次读多个 offset，例如查用户 123 在 5 天内的签到情况：
BITFIELD sign:20240501 GET u1 123 GET u1 123 GET u1 123 GET u1 123 GET u1 123（实际 offset 应为不同日期对应的不同 key，这里仅为示意语法）
更常见的是用 BITFIELD 做带溢出控制的计数器（比如记录本月签到次数），但注意：INCRBY u8 0 1 中的 u8 是无符号 8 位，值域 0–255，超限后默认回绕（255+1=0），不是报错。业务上需提前判断是否可能溢出，必要时用 i16 或拆成多个字段。
容易被忽略的点：Redis 6.0+ 默认开启 bitfield-max-heap-size 限制，大 offset 的 BITFIELD 可能触发内存分配失败，报错 OOM command not allowed when used memory > 'maxmemory' —— 即使实际只用了几个 bit。
