Redis GETRANGE 怎么截取二进制字段：字节下标、负数边界与返回值核对

排查 Redis 中一段被截断的 token 时，最容易把 GETRANGE 当成“按字符切片”。它实际按字节下标工作，起止位置都包含在结果里，负数下标从值的末尾计算；请求超出范围时 Redis 会返回可用部分，而不是抛出越界异常。

把 GETRANGE 当作闭区间的字节切片来验收：先确认原始值的长度，再分别核对正数下标、负数下标和空区间的返回值。

GETRANGE 的闭区间到底覆盖哪些字节

先准备一个没有多字节字符的短值，排除编码干扰。下面的 session:raw-token 包含 10 个 ASCII 字节：

SET session:raw-token abcdefghij
GETRANGE session:raw-token 0 3
GETRANGE session:raw-token 4 -1

第一条 GETRANGE 返回 abcd，因为 0、1、2、3 四个位置都被包含；第二条从位置 4 取到末尾，返回 efghij。这也是拆分固定头部和剩余数据时最稳的写法：头部用明确的闭区间，尾部用 -1 收口。

负数下标和越界返回为什么容易误导排查

负数下标的计算以最后一个字节为 -1、倒数第二个字节为 -2。对上面的 10 字节值，GETRANGE session:raw-token -4 -1 等价于取位置 6 到 9，因此结果是 ghij。

越界也有明确的边界：start 小于 -length 时按第一个字节起算，end 大于等于长度时按最后一个字节收口；但如果 start 在逻辑上位于 end 之后，Redis 只返回空字符串。这个空字符串和键不存在不是一回事，排查时应再用 EXISTS 或 GET 确认。

EXISTS session:raw-token
GETRANGE session:raw-token -99 2
GETRANGE session:raw-token 7 99
GETRANGE session:raw-token 9 2

如果值来自中文文本或二进制 token，先用 STRLEN 看 Redis 保存的字节长度。可见字符数、UTF-8 字节数和业务字段长度不是同一个概念；把中文按“一个字节”计算，会让切片落在字符中间，返回结果可能无法按文本显示，但这不代表 Redis 截取失败。

用三组检查把返回值核对完整

1. 先执行 EXISTS session:raw-token 和 STRLEN session:raw-token，确认键确实存在以及字节长度。
2. 用一个正数区间和一个负数区间重复读取，例如 0 3 与 -4 -1，把结果拼接关系和预期字段边界对上。
3. 专门测试 start > end 和超大 end，记录空字符串、截断结果和键不存在三种状态，不要只看客户端是否显示内容。

在应用代码里，GETRANGE 适合读取固定前缀、尾部摘要或协议字段的一段窗口；它不负责字符集解码，也不会替你校验 token 是否完整。切片后仍要把长度、校验和或协议版本交给业务层判断。

常见问题

GETRANGE 的 end 是不是不包含？

包含。0 3 会返回四个字节，这是它和许多半开区间 API 最容易不同的地方。

start 大于 end 会报错吗？

不会，Redis 返回空字符串。要区分它与键不存在，需要额外检查键状态。

GETRANGE 能按中文字符截取吗？

不能直接按可见字符截取，它按字节工作。中文场景应先确定 UTF-8 字节边界，再交给应用层做安全解码。

为什么客户端看到的长度和 STRLEN 不一样？

客户端可能按字符、转义文本或二进制显示；STRLEN 反映 Redis 字符串保存的字节长度，应以它作为 Redis 区间计算基准。

总结

GETRANGE 的核心不是“截取一段文字”，而是从 Redis 字节序列中读取一个包含两端的窗口。掌握正负下标、越界收口和空字符串语义，再配合 STRLEN 与 EXISTS，固定前缀、尾部摘要和二进制字段的排查就不会混在一起。