java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > SpringBoot分页查询

SpringBoot基于JPA和MyBatis完成分页查询的最佳实践教学

作者：菩提风

分页查询是业务系统中最常见的数据访问需求之一,本文将分享如何基于Spring Data JPA和MyBatis两种主流持久层方案,实现既符合规范又高效的分页方案,有需要的小伙伴可以参考下

1. Spring Boot分页查询的核心价值

分页查询是业务系统中最常见的数据访问需求之一。想象一下电商平台的商品列表、社交媒体的动态流、后台管理系统的数据表格——这些场景都离不开高效的分页实现。Spring Boot作为Java生态中最主流的应用框架，其分页能力直接关系到系统性能和用户体验。

我在实际项目中发现，许多开发者对Spring Boot分页存在两个极端：要么简单调用JPA的findAll()方法然后在内存中分页（性能灾难），要么过度设计复杂的自定义分页（维护噩梦）。本文将分享如何基于Spring Data JPA和MyBatis两种主流持久层方案，实现既符合规范又高效的分页方案。

2. JPA分页的标准化实现

2.1 Pageable接口与Page对象

Spring Data JPA通过 Pageable 接口抽象分页请求，其核心参数包括：

查询结果包装在 Page<T> 对象中，包含：

public interface Page<T> {
    int getTotalPages();     // 总页数
    long getTotalElements(); // 总记录数
    List<T> getContent();    // 当前页数据
    // 其他元数据...
}

2.2 三种分页查询方式对比

方式1：Repository接口自动生成

public interface UserRepository extends JpaRepository<User, Long> {
    Page<User> findByNameContaining(String name, Pageable pageable);
}

方式2：@Query注解自定义JPQL

@Query("SELECT u FROM User u WHERE u.status = :status")
Page<User> findByStatus(@Param("status") Integer status, Pageable pageable);

方式3：原生SQL查询

@Query(value = "SELECT * FROM users WHERE age > ?1", 
       countQuery = "SELECT count(*) FROM users WHERE age > ?1",
       nativeQuery = true)
Page<User> findUsersByAge(int age, Pageable pageable);

关键选择 ：优先使用方式1，复杂查询用方式2，性能敏感场景才用方式3。原生SQL需要显式指定countQuery，否则会导致分页元数据错误。

2.3 分页性能优化实践

索引设计原则

-- 分页查询的黄金组合索引
CREATE INDEX idx_name_status ON users(name, status);

N+1查询问题规避

@EntityGraph(attributePaths = {"department"}) // 预加载关联实体
Page<User> findByDepartmentId(Long deptId, Pageable pageable);

延迟计数优化

// 当不需要总记录数时（如无限滚动）
Pageable.unpaged().withoutTotal();

3. MyBatis分页的灵活方案

3.1 PageHelper插件配置

# application.yml
pagehelper:
  helperDialect: mysql
  reasonable: true
  supportMethodsArguments: true

3.2 基础分页实现

PageHelper.startPage(1, 10); // 页码, 页大小
List<User> users = userMapper.selectByExample(example);
PageInfo<User> pageInfo = new PageInfo<>(users);

3.3 复杂SQL分页技巧

嵌套查询分页

<select id="selectWithRoles" resultMap="userWithRoles">
  SELECT u.* FROM users u
  WHERE u.id IN (
    SELECT user_id FROM user_roles 
    WHERE role_id = #{roleId}
    LIMIT #{offset}, #{limit}
  )
</select>

游标分页（适用于大数据量）

// 使用last_id作为游标
List<User> users = userMapper.selectAfterId(lastId, pageSize);

4. 前端分页对接规范

4.1 RESTful接口设计

{
  "data": [...],
  "pagination": {
    "current_page": 1,
    "page_size": 10,
    "total_items": 100,
    "total_pages": 10
  }
}

4.2 常见问题解决方案

页码漂移问题

// 使用createAt作为游标替代页码
List<User> users = userRepository.findByCreateAtAfter(
    lastUserCreateAt, 
    PageRequest.of(0, size, Sort.by("createAt")));

深度分页优化

-- 避免OFFSET过大
SELECT * FROM users 
WHERE id > (SELECT id FROM users ORDER BY id LIMIT 100000, 1)
LIMIT 20;

5. 生产环境经验总结

监控指标 ：

缓存策略 ：

@Cacheable(value = "userPage", key = "#name.concat('-').concat(#pageable)")
public Page<User> findByName(String name, Pageable pageable) {
    // ...
}

防御性编程 ：

public Pageable sanitizePageable(Pageable pageable) {
    int size = Math.min(pageable.getPageSize(), MAX_PAGE_SIZE);
    return PageRequest.of(pageable.getPageNumber(), size);
}

在千万级数据量的电商项目中，通过组合游标分页+覆盖索引，我们将商品列表页的P99响应时间从1200ms降低到200ms。分页看似简单，但魔鬼藏在细节里——正确的排序字段选择、合理的页大小设置、精准的索引覆盖，这些才是高并发场景下的制胜关键。

到此这篇关于SpringBoot基于JPA和MyBatis完成分页查询的最佳实践教学的文章就介绍到这了,更多相关SpringBoot分页查询内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:
阅读全文