Oracle存储函数返回SYS_REFCURSOR时JDBC预取是否生效？

嘿，这个问题我之前帮团队排查过类似的场景，刚好能给你捋清楚关键点！

JDBC驱动的默认预取设置确实会影响从PL/SQL包函数返回的游标获取数据的流程，但这里有几个容易踩的坑，得结合你的配置和代码细节来看。

Oracle JDBC对PL/SQL游标的预取逻辑 #

当你的Java代码通过JDBC调用PL/SQL函数拿到返回的REF CURSOR时，Oracle JDBC驱动会把当前的预取大小（会话级/语句级）应用到这个游标上：

• 默认情况下，Oracle JDBC的预取大小是10（不同版本略有差异，比如11g是10，12c+有些版本调整到了20，但核心逻辑一致）。
• 这里要注意：如果PL/SQL函数内部显式用DBMS_SQL.SET_FETCH_SIZE给游标设置了取数大小，JDBC会优先使用PL/SQL里的设置，除非你在JDBC层面显式重新覆盖。

JBoss配置预取的那些坑 #

你提到在JBoss配置文件里设置预取大小，这里得分两种情况看：

• 数据源全局配置：如果是在<datasource>节点里配置prefetch-size参数，这个会作为该数据源所有连接的默认预取大小，包括处理PL/SQL游标的连接。但要注意：如果你的代码里给CallableStatement或者拿到的ResultSet显式设置了预取大小，代码里的设置会直接覆盖数据源的默认值。
• 版本兼容性问题：有些老版本的JBoss（比如EAP 6.x之前）对PL/SQL游标的预取支持有小bug——如果你的REF CURSOR是作为函数返回值输出的，可能需要在CallableStatement上显式设置预取，而不是只依赖数据源配置。举个例子：

  // 显式给CallableStatement设置预取大小，确保生效
  CallableStatement cs = conn.prepareCall("{ ? = call YOUR_PACKAGE.YOUR_TARGET_FUNCTION() }");
  cs.registerOutParameter(1, OracleTypes.CURSOR);
  cs.setFetchSize(100); // 这里的设置会覆盖数据源默认和JDBC默认
  cs.execute();
  ResultSet rs = (ResultSet) cs.getObject(1);
  

• 另外要检查配置参数名是否正确：JBoss数据源里的预取参数是prefetch-size（带连字符），别写成fetchSize这种驼峰形式，不然配置根本不会生效。

怎么验证预取是否真的生效了？ #

光配置了还不够，得确认实际生效了才行：

• 可以用Oracle的系统视图查看等待事件：执行下面的SQL（替换成你的会话ID），看SQL*Net message from client的等待次数——预取越大，这个等待次数越少（因为每次取更多数据，减少网络交互）：

  SELECT event, total_waits 
  FROM v$session_event 
  WHERE sid = YOUR_SESSION_ID 
    AND event = 'SQL*Net message from client';
  

• 也可以开启Oracle JDBC的日志（比如添加JVM参数-Doracle.jdbc.Trace=true），查看日志里的fetch size相关输出，确认实际使用的预取大小是多少。

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