Oracle BLOB操作须用setBinaryStream流式写入和getBinaryStream流式读取,避免setBytes/getBytes导致内存溢出;必须在事务内完成,且需匹配ojdbc驱动与JDK版本。
Oracle BLOB写入:用setBinaryStream代替setBytes
直接调用setbytes把整张图片塞进blob,内存会爆——尤其上传几十mb的扫描件时。oracle驱动在setbytes内部会把字节数组全加载进jvm堆,还可能触发临时表空间写满错误。
正确做法是用setBinaryStream走流式写入,让数据从源文件/HTTP请求体直通数据库,不经过Java堆中转:
-
PreparedStatement.setBinaryStream(int parameterIndex, InputStream inputStream, long length)是最稳的签名(JDBC 4.0+),length必须传真实字节数,Oracle不支持-1或null - 如果源头是
FileInputStream,先用file.length()算准长度;如果是Servlet的Part.getInputStream(),得提前读一遍或依赖前端传Content-Length - 别在
try-with-resources里关InputStream——setBinaryStream只是注册流,真正读取发生在executeUpdate()时,提前关闭会抛IOException: Stream closed
Oracle BLOB读取:用getBinaryStream拿流,别用getBytes
查BLOB时调用ResultSet.getBytes("blob_col"),等于把整个二进制内容拷贝成byte[]再扔进内存。一张5MB图片就占10MB堆(字节数组+临时缓冲区),并发高点直接OOM。
真实业务里你通常要写到响应输出流、转Base64、或喂给图像处理库,根本不需要全量字节数组:
- 用
ResultSet.getBinaryStream("blob_col")拿到InputStream,直接IOUtils.copy(inputStream, response.getOutputStream())(Apache Commons)或用NIOFiles.copy() - 注意Oracle驱动返回的流不是markable的,不能反复读;如果业务需要多次消费(比如先校验MD5再写磁盘),得自己缓存到
ByteArrayOutputStream或临时文件 - 某些旧版ojdbc6驱动对空BLOB返回
null流,得先用rs.wasNull()判断,ojdbc8已修复
事务与LOB定位:BLOB操作必须在事务内完成
Oracle的BLOB不是普通字段——它本质是LOB locator(定位器)。你在INSERT语句里用empty_blob()占位,实际数据是在后续UPDATE中通过locator写进去的。这个过程强依赖事务上下文。
典型翻车场景:Spring声明式事务里,@Transactional方法分两步——先insert生成空BLOB,再update写入流。如果中间有非事务方法调用、或事务被意外传播中断,locator就失效,setBinaryStream会抛SQLException: ORA-22288: file or LOB operation failed。
- 确保整个BLOB写入流程(INSERT + setBinaryStream + executeUpdate)在同一个数据库连接和事务中完成
- 用
Connection.createBlob()手动创建BLOB对象再set进PreparedStatement,虽绕过empty_blob()但仍有同样事务要求 - Web应用里常见坑:Controller层开事务,Service里调用两次DAO(一次insert,一次update),但第二次DAO用了新连接——必须用
@Transactional(propagation = Propagation.REQUIRED)保证复用同一连接
ojdbc版本与JDK兼容性:别用ojdbc6跑JDK 17+
ojdbc6只支持到JDK 8,硬塞进JDK 17会出诡异问题:BLOB流读到一半就EOF、setBinaryStream静默失败、甚至JVM崩溃。Oracle官网明确写了ojdbc6不支持JDK 9+的模块系统。
选型看清楚三点:
- JDK 8 → ojdbc6(
com.oracle.jdbc:ojdbc6) - JDK 11–17 → ojdbc8(
com.oracle.database.jdbc:ojdbc8),注意Maven坐标变了 - JDK 21+ → 必须用ojdbc11或更高,且确认驱动支持你的Oracle服务端版本(如Oracle 19c需ojdbc11.2.0.4+)
- 所有新版ojdbc都要求显式设置
oracle.jdbc.useFetchSizeWithLongColumn=true(加在JDBC URL里),否则大BLOB查询可能卡住或超时
流式读写本身不难,难的是每一步都踩在Oracle LOB机制和JDBC驱动实现的缝隙上——事务生命周期、驱动版本、流的生命周期管理,三者错一个,BLOB就变成黑洞。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










