如何配置MyBatis Plus适配Oracle分页

星婷小哥_2838

星婷小哥_2838

2026-07-21

686人浏览

原创

必须指定dbtype.oracle,否则分页sql会误用limit语法而非rownum导致报错;多数据源需隔离配置,不能全局共用;page构造须显式传参pagenum和pagesize,避免默认值失效;禁用pagehelper防止拦截器冲突;开启debug日志验证sql是否含rownum结构。

如何配置mybatis plus适配oracle分页

PaginationInnerInterceptor 必须设为 DbType.ORACLE,否则生成的 SQL 会用错语法(比如拼 LIMIT 而非 ROWNUM),直接报错或返回空结果。

MybatisPlusInterceptor 配置必须用 DbType.ORACLE

新版 MyBatis-Plus(3.4.0+)弃用了 PaginationInterceptor,改用 MybatisPlusInterceptor + PaginationInnerInterceptor。Oracle 分页依赖 ROWNUM 语义,拦截器类型不匹配就会失效。

  • 正确写法:interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.ORACLE));
  • 错误写法:new PaginationInnerInterceptor(DbType.MYSQL) 或 new PaginationInnerInterceptor(DbType.H2)
  • 若项目同时连多个库(如 Oracle + MySQL),需按数据源隔离配置,不能全局共用一个拦截器

Page 构造必须传参,不能只 new Page()

Page<user> page = new Page();</user> 是常见坑:它默认 current=1、size=10,但部分版本(尤其搭配 YashanDB 时)可能忽略默认值,导致查出全表数据或空集合。

QuantOracle
QuantOracle

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

下载
  • 显式传参最稳:Page<user> page = new Page(pageNum, pageSize);</user>
  • pageNum 从 1 开始,不是 0;传 0 或负数会触发异常或静默归零
  • 如果前端传了非法页码(如 pageNum=0),建议在 Controller 层校验,避免穿透到拦截器

YashanDB 可以走 Oracle 模式,但别混用 PageHelper

YashanDB 兼容 Oracle 的 ROWNUM 语法,所以用 DbType.ORACLE 完全可行。但它不兼容 PageHelper 的方言配置(比如 pagehelper.helperDialect=oracle),那是另一套插件体系。

  • 只启用 MyBatis-Plus 自带分页,禁用 PageHelper 相关 starter 和配置
  • 如果已引入 pagehelper-spring-boot-starter,必须排除,否则两个拦截器打架,SQL 被重写两次
  • 验证是否生效:开启 MyBatis 日志(logging.level.com.yourpackage.mapper=DEBUG),看实际执行 SQL 是否含 WHERE ROWNUM ? 结构

Oracle 分页性能敏感,注意 total 查询开销

MyBatis-Plus 默认会额外执行一条 SELECT COUNT(*) 获取总条数,Oracle 上全表扫描成本高,尤其大表没走索引时。

  • 业务明确不需要总页数(如“下一页”模式),可关掉:page.setSearchCount(false)
  • 确保 COUNT 查询能命中索引——避免 COUNT(*) 扫描大表,优先建覆盖索引
  • YashanDB 对 ROWNUM 优化较好,但嵌套子查询深度过大仍可能慢,避免在分页外层再套复杂聚合
真正容易被忽略的是:YashanDB 虽然兼容 Oracle 语法,但它对 ROWNUM 的解析边界比 Oracle 更严格——比如子查询里不能直接 ORDER BY 后接 ROWNUM,MyBatis-Plus 生成的 SQL 已处理这点,但自定义 SQL 时得手动加一层括号包装。

相关文章

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

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

下载

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

相关专题

更多
mybatis一级缓存和二级缓存
mybatis一级缓存和二级缓存

在MyBatis中,一级缓存和二级缓存是两种不同级别的缓存机制,它们都可以用来提高性能。本专题提供mybatis一级缓存和二级缓存相关文章,大家可以免费阅读。

2023.08.21

583

4

ibatis和mybatis有什么区别
ibatis和mybatis有什么区别

ibatis和mybatis的区别:1、基本信息不同;2、开发时间不同;3、功能与易用性;4、配置文件;5、入参类型与出参类型;6、返回结果集接受方式;7、语法差异;8、数据库方言支持;9、插件支持;10、社区活跃度;11、全球化支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

2402

5

mybatis如何配置数据库连接
mybatis如何配置数据库连接

mybatis配置数据库连接的方法:1、指定数据源;2、配置事务管理器;3、配置类型处理器和映射器;4、使用环境元素;5、配置别名。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

446

5

mybatis工作原理及流程是什么
mybatis工作原理及流程是什么

mybatis工作原理及流程:1、配置文件;2、接口与映射;3、sql解析与生成;4、执行计划;5、结果处理;6、动态sql;7、缓存机制;8、插件;9、事务管理;10、日志与监控;11、扩展性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

292

4

hibernate和mybatis有哪些区别
hibernate和mybatis有哪些区别

hibernate和mybatis的区别:1、实现方式;2、性能;3、对象管理的对比;4、缓存机制。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

302

5

Java MyBatis框架
Java MyBatis框架

本专题专注于Java主流ORM框架MyBatis的应用,系统讲解SQL映射、动态SQL、结果映射、分页查询、缓存机制与多表关联等核心内容,并结合企业管理系统、电商平台和后台管理项目实战,帮助学员全面掌握高效的数据库持久层开发技能。

2025.08.26

5629

22

oracle清空表数据
oracle清空表数据

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

2023.08.16

941

5

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

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

2023.09.15

2713

5

oracle怎么分页
oracle怎么分页

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

2023.09.18

2750

5

热门下载

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

精品课程

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