Spring Data Cassandra无pageState时无法获取第2页的问题

你遇到的这个IllegalArgumentException其实是Spring Data Cassandra和Cassandra数据库本身的分页机制决定的，和传统关系型数据库的分页逻辑完全不一样。

为什么会报错？ #

Cassandra是分布式数据库，它不支持关系型数据库那种基于偏移量的分页（比如LIMIT x OFFSET y），而是依赖**分页状态令牌（Paging State）**来实现分页——简单说就是必须用上一页返回的专属令牌来获取下一页数据，没法直接通过页码（比如第2页）跳转到指定页。而CassandraPageRequest.of(int page, int size)方法里的断言就是在强制执行这个规则：只允许page=0（也就是第一页）用页码初始化，后续页面必须依赖上一页的令牌。

正确的分页实现方式 #

1. 获取第一页数据

用page=0初始化分页请求，得到第一页的Slice对象（推荐用Slice而非Page，因为Cassandra无法高效计算总条数，Page的总页数/总条数查询会带来性能损耗）：

int pageSize = 10;
// 获取第一页
Slice<YourEntity> currentPage = yourEntityRepository.findAll(CassandraPageRequest.of(0, pageSize));

2. 获取后续页面（比如第二页、第三页）

通过上一页Slice的getPageable().next()方法，直接生成带有分页令牌的下一页请求，不需要手动指定页码：

// 检查是否有下一页
if (currentPage.hasNext()) {
    // 生成下一页请求，自动携带上一页的分页令牌
    CassandraPageRequest nextPageRequest = (CassandraPageRequest) currentPage.getPageable().next();
    // 获取第二页数据
    Slice<YourEntity> secondPage = yourEntityRepository.findAll(nextPageRequest);
}

3. 跳转到指定页码（比如第N页）

如果确实需要跳转到某一页，只能通过循环逐页获取的方式，因为Cassandra不支持直接跳转：

int targetPage = 3; // 目标是第3页
int currentPageNum = 0;
Slice<YourEntity> currentSlice = yourEntityRepository.findAll(CassandraPageRequest.of(currentPageNum, pageSize));

// 循环获取直到目标页
while (currentPageNum < targetPage - 1 && currentSlice.hasNext()) {
    currentSlice = yourEntityRepository.findAll((CassandraPageRequest) currentSlice.getPageable().next());
    currentPageNum++;
}
// 此时currentSlice就是第3页的数据

4. 分页令牌的序列化（用于前后端交互）

如果需要把分页状态传递给前端（比如保存分页位置），可以把分页令牌转换成Base64字符串：

// 序列化：把分页令牌转成Base64字符串
byte[] pagingState = ((CassandraPageRequest) currentPage.getPageable()).getPagingState();
String encodedState = Base64.getEncoder().encodeToString(pagingState);

// 反序列化：用Base64字符串重建分页请求
byte[] decodedState = Base64.getDecoder().decode(encodedState);
CassandraPageRequest pageRequest = CassandraPageRequest.of(0, pageSize, decodedState);
Slice<YourEntity> page = yourEntityRepository.findAll(pageRequest);

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