MyBatis-Plus怎么在Oracle数据库中实现物理分页查询?

浅丽君_3705

浅丽君_3705

2026-11-12

596人浏览

原创

必须用PaginationInnerInterceptor配Oracle方言,因MyBatis-Plus 3.4.0+已废弃PaginationInterceptor;拦截器必须指定DbType.ORACLE,否则生成LIMIT而非ROWNUM导致报错或空结果;多数据源需隔离配置,禁用PageHelper,Page构造须显式传pageNum和pageSize,并开启DEBUG日志验证SQL含ROWNUM。

mybatis-plus怎么在oracle数据库中实现物理分页查询?

必须用 PaginationInnerInterceptor 配 Oracle 方言

MyBatis-Plus 3.4.0+ 已废弃 PaginationInterceptor,硬写它会直接失效。Oracle 分页依赖 ROWNUM 嵌套结构,拦截器必须明确告知数据库类型,否则生成的 SQL 还是 LIMIT,一执行就报错或返回空。

正确配置只有一行关键:interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.ORACLE))。写成 DbType.MYSQL 或漏掉 DbType 参数,SQL 就不会重写为 WHERE ROWNUM ? 形式。

  • 多数据源项目不能共用一个 MybatisPlusInterceptor 实例,需按数据源隔离配置
  • 如果同时引入了 pagehelper-spring-boot-starter,必须彻底排除——两个分页插件叠加会导致 SQL 被重写两次,结果不可预测
  • 验证是否生效:开启 logging.level.com.yourpackage.mapper=DEBUG,看日志里实际执行的 SQL 是否含 ROWNUM 关键字

Page 构造必须显式传 pageNum 和 pageSize

Page page = new Page() 看似简洁,但它是隐患源头。虽然默认 current=1、size=10,但在 Oracle 场景下(尤其搭配 YashanDB 或某些驱动版本),这些默认值可能被忽略,导致查出全表数据或空集合。

安全写法永远是:Page page = new Page(pageNum, pageSize)。注意:pageNum 从 1 开始,传 0 或负数会触发异常或静默归零。

  • 前端传参不可信,pageNum 和 pageSize 应在 Controller 层做校验,比如 pageNum 则抛 IllegalArgumentException
  • 若业务允许“无总页数”模式(如仅提供“下一页”按钮),调用前加 page.setSearchCount(false),避免额外 COUNT(*) 扫描大表
  • 确保 COUNT 查询能命中索引,否则 Oracle 全表扫描开销极高;必要时建覆盖索引

分页 SQL 实际长什么样?别只信文档

MyBatis-Plus 对 Oracle 的物理分页不是黑盒。它最终生成的 SQL 是三层嵌套结构,类似:

QuantOracle
QuantOracle

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

下载
SELECT * FROM (
  SELECT TMP_PAGE.*, ROWNUM RN FROM (
    SELECT * FROM USER WHERE STATUS = 'ACTIVE'
  ) TMP_PAGE WHERE ROWNUM  ?

外层 RN > ? 保证跳过前 N 条,内层 ROWNUM 控制上限。这个结构对 Oracle 是必须的,因为 ROWNUM 是在结果集生成时动态分配的,不能直接写 WHERE ROWNUM BETWEEN ? AND ?。

  • 如果你在日志里看到的是单层 SELECT ... WHERE ROWNUM ,说明分页没生效,大概率是拦截器没配对或 Page 没传参
  • 自定义 SQL(如 @Select)不会被自动分页,除非手动在 XML 中写 或用 RowBounds,但那已脱离 MyBatis-Plus 分页体系
  • 关联查询分页要格外小心:COUNT 子句和主查询的 JOIN 逻辑必须一致,否则总数和列表数据不匹配

为什么 total 查询慢?Oracle 的 COUNT 不是免费的

MyBatis-Plus 默认每次分页都执行一条 SELECT COUNT(*),Oracle 上这句可能比主查询还慢,尤其当表大、没走索引、或 WHERE 条件涉及函数/表达式时。

这不是框架 bug,而是 Oracle 优化器对 COUNT(*) 的处理机制决定的——它往往需要访问所有符合条件的数据块,无法单纯靠索引快速估算。

  • 确认 COUNT 是否走索引:用 EXPLAIN PLAN 查看执行计划,重点看 access 和 filter 是否落在索引列上
  • 如果业务场景允许模糊总数(如“约 5000+ 条”),可关掉计数:page.setSearchCount(false)
  • 对高频分页的大表,考虑用异步任务定期缓存总数,或改用游标分页(WHERE id > ? ORDER BY id LIMIT ?)绕过 COUNT

Oracle 分页真正卡点不在语法,而在 COUNT 性能和多数据源隔离。很多人配对了 DbType.ORACLE 就以为万事大吉,结果上线后发现首页快、翻到第 50 页就超时——那八成是 COUNT 没压住。

相关文章

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

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

下载

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

相关专题

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

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

2023.08.16

1141

5

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

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

2023.09.15

3413

5

oracle怎么分页
oracle怎么分页

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

2023.09.18

3410

5

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

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

2023.09.19

1949

3

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

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

2023.09.19

2553

7

oracle imp
oracle imp

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

2023.09.19

3569

4

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

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

2023.11.02

4929

19

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

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

2023.11.08

257

5

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

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

2023.11.14

946

5

热门下载

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

精品课程

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