Oracle 12c+ 分页需用 FETCH NEXT,但要求 JDBC 驱动 ≥12.1.0.2(如 ojdbc8.jar),低版本会报 ORA-00933;ROWNUM 方式必须两层嵌套且 ORDER BY 在最内层;FETCH NEXT 参数须用 setLong 绑定,排序含 NULL 时需显式声明 NULLS LAST。
Oracle 12c+ 用 FETCH NEXT,但 JDBC 驱动版本太低会报错
java 里直接写 select * from t order by id fetch next 10 rows only 看似干净,实际运行时可能抛出 ora-00933: sql command not properly ended——这不是 sql 写错了,是 jdbc 驱动不认这个语法。oracle 12c 引入的 fetch next 需要 oracle jdbc driver 12.1.0.2 或更高版本才支持。低于该版本(比如常见的 ojdbc6.jar)会把 fetch 当作非法关键字。
实操建议:
- 检查当前项目使用的 JAR 包:看文件名是否含
ojdbc8.jar或ojdbc11.jar;若为ojdbc6.jar或ojdbc7.jar,必须升级 - 升级后仍报错?确认
Connection没有被旧驱动缓存——重启应用、清空 classloader、删掉 IDE 的 output/cache 目录 -
ojdbc8.jar支持 JDK 8+,且默认开启对FETCH NEXT的解析,无需额外配置
ROWNUM 嵌套写法必须带排序子查询,否则分页结果错乱
很多人照搬网上模板写 SELECT * FROM (SELECT ROWNUM rn, t.* FROM table t) WHERE rn BETWEEN ? AND ?,结果发现第 2 页数据和第 1 页重复,或顺序随机。根本原因是 ROWNUM 在 Oracle 中是“取行时分配”的,它不等价于“按某列排序后的序号”。没加 ORDER BY 的子查询,Oracle 可能每次返回不同物理顺序,ROWNUM 就跟着飘。
正确写法必须两层嵌套,且 ORDER BY 要落在最内层:
SELECT * FROM (
SELECT ROWNUM rn, t.* FROM (
SELECT * FROM users ORDER BY created_time DESC
) t
) WHERE rn BETWEEN 11 AND 20常见错误:
立即学习“Java免费学习笔记(深入)”;
- 把
ORDER BY放在外层:无效,ROWNUM已经分配完了 - 子查询里漏了括号或别名,导致语法错误或逻辑错位
- 用
ROWNUM <= N单边过滤(如WHERE ROWNUM <= 20),无法跳过前 N 行,只能用于取前 N 条
JDBC PreparedStatement 绑定 FETCH NEXT 参数要小心位置和类型
FETCH NEXT ? ROWS ONLY 看起来能用 PreparedStatement.setLong(1, 10),但 Oracle JDBC 对这个位置参数的支持在早期 ojdbc8 版本中并不稳定——某些补丁版本会把 ? 当作文本字面量处理,导致 ORA-01785(ORDER BY 项必须在 SELECT 列表中)这类误报。
更稳妥的做法是:参数只用于偏移量和数量,不用于 FETCH 关键字本身。例如:
SELECT * FROM orders ORDER BY id OFFSET ? ROWS FETCH NEXT ? ROWS ONLY
这时两个 ? 都必须用 setLong(不能用 setInt),因为 Oracle 内部将偏移量和行数视为 NUMBER 类型,JDBC 驱动在类型推断失败时可能截断或报 SQLException。
注意点:
- 第一个参数(
OFFSET)可以为 0,但不能为负数,否则报ORA-01785 - 如果业务允许,优先用
setLong(1, (page - 1L) * size)计算偏移,避免整数溢出 - 不要在同一个 SQL 里混用
ROWNUM和FETCH,驱动解析行为未定义
分页字段含 NULL 时,ORDER BY 必须显式声明 NULLS LAST
Oracle 默认把 NULL 排在最前面(NULLS FIRST),而多数业务期望非空值优先展示。如果你分页查一个状态字段(如 status),其中大量为 NULL,又没加 NULLS LAST,第 1 页可能全是 NULL 行,用户以为数据为空。
这个问题在 ROWNUM 和 FETCH NEXT 两种方式下都存在,但 FETCH NEXT 更隐蔽——因为语法看起来“现代”,容易忽略排序细节。
正确写法示例:
SELECT * FROM products ORDER BY status NULLS LAST, id DESC OFFSET 0 ROWS FETCH NEXT 10 ROWS ONLY
关键提醒:
-
NULLS FIRST/LAST是 Oracle 特有语法,MySQL/PostgreSQL 不兼容,换库时要重写 - 如果排序字段建了索引,确保索引也包含
NULLS LAST语义(Oracle 12c+ 支持函数索引如CREATE INDEX idx ON t(status, id) NULLS LAST) - 用
ROWNUM方式时,NULLS LAST必须写在最内层子查询的ORDER BY中,否则无效
Oracle 分页真正难的不是语法,是驱动版本、NULL 排序、参数类型这三处细节叠在一起时,错误现象和真实原因完全不匹配。调半天发现是 jar 包太老,或者 ORDER BY 少写了 NULLS LAST,这种事很常见。










