讲师中心 微信公众号
AI工具推荐 视频效率加速

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

夏强姑娘_8814

夏强姑娘_8814

发布时间:2026-11-05 12:24:47

|

558人浏览过

|

来源于php中文网

原创

必须配置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 分配不稳定
  • 只写 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);
  • current 小于 1 会导致 ROWNUM ,结果为空
  • size 过大会触发 maxLimit 限制(默认无上限,但建议手动设为 500)
  • 前端传参异常(如 page=abc)需在 Controller 层校验,不能全交给 MyBatis-Plus

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

当你在 Mapper XML 中写了 <select id="xxx"></select>,哪怕方法签名是 Page<user> selectPage(Page<user> page, ...)</user></user>,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}
  )
  WHERE RN > #{page.size} * (#{page.current} - 1)
</select>
  • XML 中无法直接用 page.current 和 page.size,必须通过 #{page.xxx} 访问
  • 嵌套两层子查询是 Oracle 分页标准写法,少一层会出错
  • 这种写法绕过了 MyBatis-Plus 分页插件,total 字段不会自动填充,需额外查一次 COUNT

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

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

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

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

1101

2023.08.16

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

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

3253

2023.09.15

oracle怎么分页
oracle怎么分页

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

3270

2023.09.18

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

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

1849

2023.09.19

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

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

2473

2023.09.19

oracle imp
oracle imp

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

3429

2023.09.19

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

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

4809

2023.11.02

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

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

257

2023.11.08

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn