Spring Data JPA分页异常：访问第二页抛出UnsupportedOperationException

安全阿岳

2026-5-19

分页第二页报错？这些排查点帮你解决问题

嘿，我来帮你揪出分页第二页报错的问题！咱们从几个最常见的排查点一步步来梳理：

1. 先检查Repository层的分页方法是否正确

首先得确保你的MyEntityRepository继承了支持分页的父接口（比如JpaRepository或者PagingAndSortingRepository），而且分页查询方法的参数是Pageable，不是手动拼接页码和大小。举个正确的例子：

public interface MyEntityRepository extends JpaRepository<MyEntity, Long> {
    // 基础分页查询
    Page<MyEntity> findAll(Pageable pageable);
    
    // 带自定义条件的分页查询
    Page<MyEntity> findByStatus(String status, Pageable pageable);
}

如果是用@Query写自定义SQL，别忘了加上countQuery来统计总记录数（尤其是原生SQL的情况），不然框架没法正确计算分页信息，很容易出问题。

2. 确认Service层的分页逻辑没有搞混页码

Spring Data JPA的分页页码是从0开始的，你要确保在MyServiceImpl里构建Pageable时，没有重复处理页码。比如：

public Page<MyEntity> getMyEntities(int page, int size) {
    // 直接用接收的page参数就行，不用手动加1或减1
    Pageable pageable = PageRequest.of(page, size);
    return myEntityRepository.findAll(pageable);
}

要是你不小心把用户传的page=1又减了1，就会变成page=-1，直接抛出非法参数异常，这肯定会报错。

3. 检查Resource层的参数接收是否准确

在MyResource里，要确保正确接收page和size参数，并且没有传错给Service。比如：

@GetMapping("/myentity")
public ResponseEntity<Page<MyEntity>> getMyEntities(
        @RequestParam(defaultValue = "0") int page,
        @RequestParam(defaultValue = "20") int size) {
    Page<MyEntity> result = myService.getMyEntities(page, size);
    return ResponseEntity.ok(result);
}

这里要注意：

参数名要和用户请求的一致（用户传的是page，别写成pageNum之类的）
默认值要符合预期（比如默认size是20，和你说的无参数时返回20条一致）
别把Page对象转成List返回，不然会丢失分页元数据，但这个一般不会导致报错，只是返回数据不对。

4. 千万别忘了加稳定的排序条件！

这是最容易被忽略的坑！如果你的分页查询没有指定稳定的排序字段（比如主键id），数据库返回的结果顺序是不确定的，不仅会导致分页结果重复，还可能让框架的分页计算逻辑出错。

一定要给分页加上排序，比如在Service层构建Pageable时：

// 按id升序排序，保证结果顺序稳定
Pageable pageable = PageRequest.of(page, size, Sort.by(Sort.Direction.ASC, "id"));

或者在Repository的查询方法上直接指定排序，这样每次查询都会按固定顺序返回结果，分页逻辑就不会乱。

5. 查看完整的错误日志定位根因

你提供的日志被截断了，没法看到具体的异常信息。建议去控制台找完整的错误栈：

如果是IllegalArgumentException，大概率是页码参数非法（比如负数）
如果是SQL相关错误，可能是自定义查询的分页语法有问题
如果是PageNotFoundException，可能是请求的页码超过了总页数（比如总记录数只有10，你请求page=1&size=10，这时候没有数据，但Spring Data JPA默认不会报错，除非你开了强制校验）

另外，也可以手动查一下数据库的总记录数：SELECT COUNT(*) FROM my_entity;，看看总条数是否支持page=1的分页请求。

6. 检查是否开启了1-based页码配置

如果你在配置文件里加了spring.data.jpa.repositories.pageable-one-indexed-parameters=true，那框架会把用户传的页码当成1-based的（比如用户传page=1，框架自动转成0-based的0）。这时候要是你在Service层又手动把page减1，就会变成-1，直接触发错误。所以要确认这个配置是否存在，避免重复处理页码。

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

Spring Data JPA分页异常：访问第二页抛出UnsupportedOperationException

1. 先检查Repository层的分页方法是否正确 #

2. 确认Service层的分页逻辑没有搞混页码 #

3. 检查Resource层的参数接收是否准确 #

4. 千万别忘了加稳定的排序条件！ #

5. 查看完整的错误日志定位根因 #