Java执行update报ORA-01002 fetch out of sequence错误解决方法

核心原因 #

这个报错本质是Oracle JDBC驱动检测到结果集（游标）未完成读取、未正常关闭的状态下，程序发起了新的数据库操作，导致游标读取顺序被打乱，和你当前的代码逻辑完全匹配，常见触发场景如下：

• 前置select查询打开的结果集没有被完整消费、也没有显式关闭，就直接在同一个数据库连接、同一个事务上下文里执行了update写操作。JPA/Hibernate默认不会主动提前释放未消费完的查询游标，执行写操作会打断游标读取流程触发报错。
• JDBC连接开启了自动提交（autoCommit=true），执行executeUpdate()时会隐式提交事务，直接强制关闭当前事务下所有打开的select游标，此时如果JPA内部逻辑还需要从之前的select结果集读取剩余数据，就会抛出序列越界错误。
• 原生SQL查询没有做资源隔离，select和update复用了底层Statement对象，执行update时驱动会自动关闭该Statement绑定的结果集，后续读取直接报错。

你观察到的「更新实际执行成功」是符合报错逻辑的：update语句本身已经发送到数据库端执行完成，只是JDBC端检测到游标状态异常，在操作完成后抛出错误阻断了后续流程。

修复方案 #

• 拆分查询和更新的执行阶段，先完整消费所有select结果、释放查询资源后再执行更新
  不要在遍历select结果集的过程中执行update操作，先把所有查询需要的参数一次性拉取到内存，主动清空持久化上下文残留的托管实体后再跑更新，参考代码：

  // 第一阶段：完成全部查询逻辑，一次性拉取所有结果，释放查询游标
  Query selectQuery = entityManager.createNativeQuery("your_select_sql");
  List<Object[]> resultList = selectQuery.getResultList(); // 避免使用getResultStream()未遍历完就执行写操作
  String s = "";
  String str = "";
  for (Object[] row : resultList) {
      // 解析更新需要的参数
      s = row[0].toString();
      str = row[1].toString();
  }
  // 主动flush并清空持久化上下文，清除未处理的托管实体残留
  entityManager.flush();
  entityManager.clear();
  
  // 第二阶段：确认所有查询资源释放后，再执行更新
  Query updateQ = entityManager.createNativeQuery("your_update_sql");
  updateQ.setParameter("ItemId", s);
  updateQ.setParameter("Number", str);
  updateQ.executeUpdate();
  

• 检查事务配置，关闭JDBC自动提交
  如果是Spring环境，直接在包含select+update逻辑的业务方法上添加@Transactional注解，保证两个操作在同一个手动控制的事务范围内，避免update执行时触发隐式提交提前关闭游标。
• 对齐Oracle JDBC驱动版本
  确保ojdbc驱动大版本和使用的Oracle数据库版本完全匹配（例如Oracle 19c对应ojdbc8，Oracle 21c对应ojdbc11），低版本驱动存在游标处理逻辑bug，也会偶现该错误。
• 如果是在JPA Repository层写更新方法，必须给方法添加@Modifying注解，明确告知JPA这是写操作，避免框架按查询逻辑处理残留游标。

内容的提问来源于stack exchange，提问作者Johny Leo