如何在MyBatis-Plus中实现Oracle分页查询

夏强姑娘_8814

夏强姑娘_8814

2026-11-05

558人浏览

原创

必须配置PaginationInnerInterceptor并指定DbType.ORACLE,否则分页SQL误用LIMIT导致报错或空结果;多数据源需隔离配置;Page构造须显式传参且current≥1;Oracle分页必须添加唯一字段排序以保证ROWNUM稳定性。

如何在mybatis-plus中实现oracle分页查询

必须配置 PaginationInnerInterceptor 并指定 DbType.ORACLE

MyBatis-Plus 不会自动识别数据库类型,Oracle 分页依赖 PaginationInnerInterceptor 的方言支持。如果漏配或错配为 DbType.MYSQL,分页 SQL 会被重写成 LIMIT 形式,直接报错或返回空结果。

正确配置方式如下:

@Configuration
public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.ORACLE));
        return interceptor;
    }
}
  • 必须使用 PaginationInnerInterceptor(不是已废弃的 PaginationInterceptor)
  • DbType.ORACLE 是硬编码常量,不能传字符串 "oracle"
  • 若项目含多数据源,需确保该拦截器作用于 Oracle 数据源对应的 SqlSessionFactory

Oracle 分页必须带确定性排序,否则翻页重复

Oracle 分页底层用的是 ROWNUM 嵌套子查询,当 ORDER BY 字段存在重复值(如多个记录 create_time 相同),两次查询的物理排序顺序可能不一致,导致第 2 页开头几条和第 1 页末尾几条重复。

解决方法是强制在排序条件末尾追加主键或唯一字段:

LambdaQueryWrapper<user> wrapper = new LambdaQueryWrapper();
wrapper.orderByDesc(User::getCreateTime)
       .orderByAsc(User::getId); // 必加!避免 ROWNUM 分配不稳定</user>
  • 只写 orderByDesc(User::getCreateTime) 是常见坑点
  • 即使表有主键,也必须显式加入 orderByAsc 或 orderByDesc,不能依赖默认
  • 若用 XML 自定义 SQL,同样要在 ORDER BY 后补上 id 或其他唯一列

Page 对象构造时 current 从 1 开始,且不能为 0 或负数

Oracle 分页对页码敏感:若传 new Page(0, 10),MyBatis-Plus 会生成 ROWNUM 这类非法条件,查不到数据也不报错,静默失败。

QuantOracle
QuantOracle

63个确定性量化金融计算器 + 10个通过MCP的复合工作流。期权定价、Greeks、奇异衍生品、风险指标、投资组合优化……

下载

安全写法:

long current = Math.max(1, req.getPageNum()); // 强制兜底
long size = Math.min(500, req.getPageSize()); // 防超限
Page<user> page = new Page(current, size);</user>
  • current 小于 1 会导致 ROWNUM ,结果为空
  • size 过大会触发 maxLimit 限制(默认无上限,但建议手动设为 500)
  • 前端传参异常(如 page=abc)需在 Controller 层校验,不能全交给 MyBatis-Plus

自定义 SQL 分页需手动适配 Oracle,selectPage 不生效

当你在 Mapper XML 中写了 ,哪怕方法签名是 Page selectPage(Page page, ...),MyBatis-Plus 的拦截器也不会重写你的 SQL —— 它只处理 BaseMapper 提供的 selectPage 方法或注解 SQL。

此时必须自己写 Oracle 兼容分页:

<select id="selectUserPage" resulttype="User">
  SELECT * FROM (
    SELECT TMP.*, ROWNUM RN FROM (
      SELECT u.* FROM user u
      <where><if test="name != null and name != ''">
          AND u.name LIKE CONCAT('%', #{name}, '%')
        </if></where>
      ORDER BY u.create_time DESC, u.id ASC -- 同样要加唯一排序
    ) TMP
    WHERE ROWNUM  #{page.size} * (#{page.current} - 1)
</select>
  • XML 中无法直接用 page.current 和 page.size,必须通过 #{page.xxx} 访问
  • 嵌套两层子查询是 Oracle 分页标准写法,少一层会出错
  • 这种写法绕过了 MyBatis-Plus 分页插件,total 字段不会自动填充,需额外查一次 COUNT

Oracle 分页最易被忽略的其实是排序稳定性 —— 看似只是加个 ORDER BY,但缺了唯一字段,数据就可能在不同页间漂移,而且这种问题在线上低概率出现,极难复现和定位。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

oracle

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
oracle清空表数据
oracle清空表数据

当表中的数据不需要时,则应该删除该数据并释放所占用的空间。本专题为大家提供oracle清空表数据的相关文章,帮助大家解决该问题。

2023.08.16

1101

5

Oracle中declare的使用
Oracle中declare的使用

Oracle DECLARE语句是PL/SQL编程语言中用于声明变量、常量、游标或异常的关键字。它的主要作用是在程序中定义这些对象,以便在后续的代码中使用。DECLARE语句的语法简单明了,可以根据需要声明多个对象。通过使用这些声明的对象,可以进行各种操作,如计算、查询数据库、处理异常等 。

2023.09.15

3253

5

oracle怎么分页
oracle怎么分页

实现分页的步骤:1、使用ROWNUM进行分页查询;2、在执行查询之前进行设置分页参数;3、使用"COUNT(*)"函数来获取总行数,并使用"CEIL"函数来向上取整计算总页数;4、在外部查询中使用"WHERE"子句来筛选出特定的行号范围,以实现分页查询。想了解更多oracle怎么分页的文章,可以来阅读本专题先的文章。

2023.09.18

3250

5

Oracle查看表操作历史记录
Oracle查看表操作历史记录

查看操作历史记录的方法:1、使用Oracle内置的审计功能,可以记录数据库中发生的各种操作,包括登录、DDL语句、DML语句等;2、使用Oracle日志文件,其中包含了数据库中发生的各种操作,可以通过查看日志文件来获取操作历史记录;3、使用Oracle的Flashback功能,可以查看数据库在某个时间点的操作历史记录;4、使用第三方工具等。本专题还提供其他查看表操作的文章,大家可以免费阅读。

2023.09.19

1849

3

Oracle中RAC的用法
Oracle中RAC的用法

Oracle中RAC的用法:1、通过在多个服务器上运行数据库实例来提供高可用性;2、允许在需要时增加或减少节点数量;3、通过将工作负载分布到多个节点上来实现负载均衡;4、使用共享存储来实现多个节点之间的数据共享;5、允许多个节点同时处理数据库请求,从而实现并行处理;6、提供了透明故障切换功能;7、使用了一些技术来确保数据的一致性;8、提供了管理工具来简化RAC环境的管理和维护。本专题还提供RAC相关的其他文章,大家可以免费阅读。

2023.09.19

2473

7

oracle imp
oracle imp

imp是Oracle数据库中的一个命令行工具,用于将导出的数据和对象从一个数据库实例导入到另一个数据库实例。imp命令的一般语法为“imp username/password@connect_string file=file_name [options]”。

2023.09.19

3409

4

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

4809

19

oracle通配符有哪些
oracle通配符有哪些

oracle通配符有“%”、“_”、“[]”和“[^]"。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.08

257

5

oracle四舍五入怎么操作
oracle四舍五入怎么操作

oracle四舍五入操作可以使用ROUND函数来实现,其语法为“ROUND(number, decimal_places)”,其中,number是要进行四舍五入的数值,decimal_places是指定的小数位数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.14

886

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程