Redis BITFIELD_RO 怎么只读位段而不修改数据

需要读取 Redis 字符串中的紧凑位段、又不希望查询改变数据时，直接使用 BITFIELD_RO。它只接受 GET 子命令，多个读取结果按请求顺序返回；与同时支持 SET、INCRBY 的 BITFIELD 相比，更适合明确的只读查询和只读副本场景。

官方文档：https://redis.io/docs/latest/commands/bitfield_ro/

先固定位段布局，再读取指定编码

BITFIELD_RO 读取的是 Redis 字符串里的位，不是把整个字符串转成一个普通整数。下面先用两个写入操作构造示例数据：第 0 位起的 8 位保存状态码，第 8 位起的 8 位保存区域编号。写入只是准备数据，真正查询仍使用只读命令。

# 写入两个 8 位字段：offset 0 存状态码，offset 8 存区域编号
redis-cli BITFIELD user:flags SET u8 0 5 SET u8 8 23

# 只取第一个字段；offset 按 bit 计算，不是按字节计算
redis-cli BITFIELD_RO user:flags GET u8 0

# 一次读取两个字段，返回顺序跟两个 GET 的顺序一致
redis-cli BITFIELD_RO user:flags GET u8 0 GET u8 8

第三条命令的结果可以理解为 [5, 23]。如果把第二个请求换成 GET u8 16，读取的就是从第 16 位开始的下一个 8 位窗口。编码宽度和偏移必须由写入方、读取方共同约定；只改 u8 为 i8，同一组比特的解释范围就会变化。

BITFIELD_RO 的返回数组如何和多个 GET 对齐

每个 GET encoding offset 都对应返回数组中的一个位置。不要依据数值大小或字段名称重新排序，应用层应按发出请求时的固定顺序解包。比如下面的读取协议约定为“状态、区域、等级”，就应该按这个顺序映射。

位宽超过 8 位时，尤其要注意 i16 与 u16 的有符号差别；偏移也要按位宽连续规划，避免两个字段意外重叠。一个实用的检查方法是：先把每次 GET 的编码、偏移和业务字段名写成表，再让客户端按同一数组下标解包。

为什么读副本查询要优先使用 BITFIELD_RO

BITFIELD 同时支持读取和写入。即使本次只写了 GET，Redis 的命令能力仍包含 SET、INCRBY，在集群只读连接或副本路由中可能被按写命令处理。BITFIELD_RO 从命令能力上就限制为 GET，因此可以清楚表达“这里只查不改”的意图。

这并不意味着 BITFIELD_RO 能完成写入或自增。需要变更位段时仍要回到主节点并使用 BITFIELD；只做状态读取时再选择 BITFIELD_RO。命令从 Redis 6.2 起提供，部署环境低于该版本时应先确认服务端支持，不能只依据客户端方法名判断。

# 只读副本连接上执行查询：命令自身不包含 SET 或 INCRBY
redis-cli -h replica.example.com BITFIELD_RO user:flags GET u8 0 GET u8 8

# 需要修改字段时回到主节点；这里的注释说明了写入边界
redis-cli -h primary.example.com BITFIELD user:flags SET u8 8 24

上线前的三个小检查

1. 检查服务端版本是否至少支持 Redis 6.2，并让客户端把多个返回值保留为有序数组。
2. 检查每个字段的 bit offset、encoding 和业务下标是否在同一份协议表中，尤其关注有符号编码。
3. 检查读路径是否真的只发送 BITFIELD_RO；任何写入、递增或字段布局变更都应走主节点。

常见问题

BITFIELD_RO 能使用 SET 或 INCRBY 吗？

不能。它只接受 GET，需要修改位段时使用 BITFIELD。

多个 GET 的返回值会按 offset 自动排序吗？

不会。返回数组按子命令出现顺序排列，与 offset 数值大小无关。

offset 是字节位置还是位位置？

是 bit 偏移。字段规划时要按编码宽度计算下一个起点，不能直接把字符串下标当作 offset。