基于游标分页API：如何检测Spanner读取时间戳已过期？

我来分享下针对这个场景的具体实现思路和处理方案，刚好之前在项目里落地过类似的需求：

第一页请求处理流程 #

• 发起第一页数据查询时，先执行Spanner读取操作（可以是read()或者executeQuery()），操作完成后从结果集中提取读取时间戳
• 对这个时间戳进行编码（比如用Base64序列化，或者转成字符串后加密，确保传输安全），将其作为游标（cursor）的核心部分
• 把第一页数据、游标（包含编码后的时间戳）以及是否还有下一页的标识一起返回给前端

后续分页请求处理流程 #

• 前端携带上一页返回的游标发起请求
• 后端解码游标中的读取时间戳，将Spanner读取请求的TimestampBound设置为Exact staleness模式，传入解码后的时间戳
• 基于该时间戳执行分页读取（注意要带上分页的偏移/条件，比如基于主键的范围查询）
• 拿到当前页数据后，继续返回包含同一时间戳的游标（如果还有下一页），或者返回空游标

读取时间戳过期的处理方案 #

Spanner的读取时间戳有默认有效期（通常1小时，可通过配置调整），当时间戳过期时，尝试读取会抛出异常：

• 在后端捕获Spanner的异常，判断异常类型/错误码（比如FAILED_PRECONDITION，提示信息通常包含"timestamp too old"相关内容）
• 一旦确认是时间戳过期，就向前端返回友好提示：当前分页会话已过期，请重新加载第一页获取最新数据
• 同时可以返回对应的HTTP状态码（比如410 Gone），方便前端做统一的错误处理

另外补充几个小建议：

• 编码时间戳时，建议加上签名校验，防止前端篡改时间戳导致的非法读取
• 如果业务允许，也可以在时间戳接近过期时，自动刷新时间戳并返回新的游标，但这样会牺牲读取的一致性，需要根据业务场景权衡

内容的提问来源于stack exchange，提问作者hbakkum