Redisson RBitSet 本质是 Redis String 类型，通过 SETBIT/GETBIT 操作单个位，不支持 BITFIELD 或原子批量操作；需连续分配权限位、复用实例、避免循环创建，并用 toLong() 结合位运算校验权限。
Redisson BitMap 本质是 Redis 的 String 类型，不是独立数据结构
Redisson 的 RBitSet（常被误称为 “BitMap”）底层调用的是 Redis 的 SETBIT/GETBIT 命令，操作对象是 Redis 中一个 key 对应的 string 值。它不支持原生 Redis 6.2+ 的 BITFIELD 复合操作，也不提供原子性批量位操作（如同时 set + get 多个 offset）。权限掩码控制依赖位运算的原子性和紧凑性，这点必须提前认清。
常见错误现象：RBitSet.set(100, true) 后 get(50) 返回 false —— 因为 offset 50 未初始化，默认为 0，RBitSet 不会自动填充中间位；若误以为它是“稀疏位图”，会导致权限校验漏判。
- 权限位建议从 0 开始连续分配（如 0=读、1=写、2=删…），避免跳号
- 初始化时显式设置所有已知权限位为
false，防止未定义行为 - 单个
RBitSet实例对应一个用户/角色的权限掩码，key 命名建议含业务前缀，如perm:role:admin
set / get 操作必须配合 try-with-resources 或手动释放连接
Redisson 的 RBitSet 是懒加载的，get() 和 set() 调用会触发实际网络请求。若在高并发场景下频繁创建 RBitSet 实例（如每次 HTTP 请求 new 一个），会快速耗尽连接池或引发 RedisTimeoutException。
正确做法是复用 RBitSet 实例，但要注意：它不是线程安全的。多线程共享同一实例可能因内部缓冲区竞争出错。
立即学习“Java免费学习笔记（深入）”；
- 推荐方式：通过
RedissonClient.getBitSet("perm:user:1001")获取实例，每次使用后不 close，由 Redisson 自动管理生命周期 - 禁止在循环中反复调用
getBitSet()创建新实例；应在 service 层缓存该实例（注意线程隔离） - 若需跨方法传递，确保调用方不持有对
RBitSet的长期引用，避免内存泄漏
权限校验不能只靠 get(offset)，要结合掩码整数解析
权限掩码控制的核心是“将多个布尔权限压缩为一个整数”，而 RBitSet 只提供单 bit 操作。如果每个权限都单独 get(0)、get(1)…校验，既低效又无法体现掩码设计初衷。
更合理的方式是：用 RBitSet 存储原始位数据，但校验时先用 toLong() 或 asBinary() 转为整数，再用位运算判断。注意：toLong() 最多返回 64 位，超出部分会被截断。
RBitSet bits = redisson.getBitSet("perm:user:1001");
// 设置读(0)、写(1)权限
bits.set(0, true);
bits.set(1, true);
// 获取完整掩码值（仅限 ≤64 位）
long mask = bits.toLong(); // 返回 3（二进制 11）
boolean canRead = (mask & (1L << 0)) != 0;
boolean canWrite = (mask & (1L << 1)) != 0;
- 超过 64 位权限？改用
asBinary()得到字符串，再用BigInteger解析，但性能下降明显 -
toLong()在位数不足 64 时高位补 0，不会出错；但若业务约定“最高位表示超级权限”，需确认是否真需要 >64 位 - 避免在循环内反复调用
toLong()—— 它会重新拉取整个 bit 字符串，建议一次获取、多次位运算
分布式环境下 setBit 非原子，权限变更需加锁或用 Lua 脚本兜底
RBitSet.set(offset, value) 底层是 SETBIT key offset value，Redis 单命令是原子的，但“检查当前值 → 决策 → 设置新值”这类复合逻辑不是原子的。例如：启用某权限前想确认是否已被禁用，此时并发写入可能导致覆盖。
Redisson 没有为 RBitSet 提供 compare-and-set 类接口。硬解法只有两个：
- 用
RLock包裹读-改-写逻辑，粒度粗但简单，适合低频权限变更 - 写 Lua 脚本，通过
redisson.getScript().eval()执行，利用 Redis 单线程保证原子性，例如实现“仅当原值为 0 时设为 1” - 生产环境建议：权限变更走独立 admin 接口，由后台人工审批触发，避免前端直连位操作
真正麻烦的是权限继承场景（如角色 A 继承角色 B），这时位图 merge 需要 BITOP OR，而 RBitSet 不暴露该能力 —— 只能绕过 Redisson，用 redisson.getCommandExecutor().eval() 直接发 Lua。
