不能直接用用户ID当offset,因会导致内存爆炸、命令超时及实例阻塞;必须映射为连续小整数offset,并按日期分key、按序号分片,才能保障亿级签到的内存与性能可控。

直接用 SETBIT 按用户 ID 当 offset 存签到,对亿级用户来说是高危操作——不是不能用,而是极易因 offset 过大、稀疏或类型错乱导致内存爆炸、命令超时甚至阻塞实例。
为什么不能直接用用户 ID 当 offset?
Redis 的 SETBIT 会为指定 offset 分配完整内存块(底层是字符串),哪怕只设一个 bit。比如执行 SETBIT sign:202605 999999999 1,Redis 会分配约 125MB 内存(999999999 / 8 + 1 字节),而实际只用了 1 个 bit。
- 用户 ID 是 UUID 或随机 long(如雪花 ID)时,offset 极度稀疏,单 key 动辄几百 MB
- 用户 ID 跨越大范围但活跃度低(如最大 ID 是 2 亿,日活仅 50 万),位图有效利用率低于 0.0003%
-
BITCOUNT扫描整个分配空间,耗时与分配长度正相关,不是与 1 的个数正相关
正确做法:按时间维度建 key + 用户 ID 映射 offset
把「日期」作为 key 主体,「用户」转为紧凑 offset,才能压住内存和延迟。典型结构:sign:20260526 表示 2026 年 5 月 26 日全量签到位图,每位对应一个用户。
- 必须先将用户 ID 映射为连续小整数:用 Redis
INCR维护全局用户序号,或离线预生成uid → seq映射表(如 MySQL 自增映射) - offset = 映射后的序号,不是原始 UID;例如用户原始 ID 为 10086,映射后 seq=42,则执行
SETBIT sign:20260526 42 1 - key 命名建议带业务前缀+日期,如
sign:app_v2:20260526,避免与其他 string 混淆 - 首次写入无需初始化,
GETBIT对空 key 返回 0,BITCOUNT返回 0 —— 但要注意这不等于“当天没人签到”,得结合业务确认 key 是否应存在
当用户量真到亿级时,必须分片
即使做了 UID 映射,单日 1 亿用户也意味着位图约 12.5MB(1e8 / 8),BITCOUNT 仍可能达毫秒级,且主从同步、RDB/AOF 序列化压力陡增。
- 推荐按用户序号取模分片:如
sign:20260526:0存 seq % 64 == 0 的用户,共 64 个 key - 查单个用户:先算
seq % 64得分片号,再GETBIT sign:20260526:{shard} {seq / 64} - 统计当日总人数:并发执行 64 次
BITCOUNT sign:20260526:{i},客户端累加 —— 注意别用MGET+ 客户端位运算,BITOP不支持跨 key 聚合 - 64 分片下,单 key 控制在 ~200KB,
BITCOUNT稳定在 0.1ms 内,内存碎片也更可控
容易被忽略的三个硬坑
很多人调通了 SETBIT 就以为万事大吉,结果上线后出问题才返工:
-
SETBIT和APPEND/INCR绝对不能混用同一个 key —— 会破坏位布局,后续GETBIT返回不可预测值 - key 类型错误不会提前报:如果该 key 已存为 hash,再执行
SETBIT直接报WRONGTYPE Operation against a key holding the wrong kind of value,且无法自动转换 - 没设
expire:签到 key 如sign:20260526必须配 TTL(如 90 天),否则历史数据无限堆积,KEYS都扫不出哪些是 Bitmap











