ERR bit offset is not an integer or out of range: Bit offset is not an integer or out of range（位偏移量不是整数或超出范围）

含义

传给 SETBIT/GETBIT/BITCOUNT 等位操作的位偏移量无效：不是整数或超出允许范围。Redis 无法在该偏移量处执行位操作。

原因

传入非数字值作为偏移量；使用负偏移量；或给出超过允许上限的超大偏移量（位串最大 512 MB，即约 2^32 位）。源于基于 bitmap 的计数器/标志结构中的计算错误。

解决方法

确保偏移量是允许范围内的非负整数（0 到 ~2^32-1；字符串最大 512 MB）。校验偏移量计算（例如由用户 ID 推导出的偏移量）是否溢出/为负。如果需要非常大的偏移量，将数据设计为拆分到多个键中（分片）。