Oracle BFILE 是只读外部文件指针，需通过 OracleBfile 实例显式 openFile() 后流式读取；不可用 getBytes()/getString()，否则报 ORA-22285；服务端须预定义 DIRECTORY 并授读权限。
Oracle BFILE 不能直接用 ResultSet.getBytes() 或 getString() 读取
这是最常踩的坑：bfile 不是把文件内容存进数据库，而只是指向操作系统上某个目录和文件的指针。试图用常规 lob 方法读取会抛出 sqlexception: ora-22285（找不到目录对象或文件）或返回空/乱码。java 端必须通过 oraclebfile 实例显式打开、定位、流式读取，且前提是 oracle 服务端已正确定义了对应 directory 对象，并赋予用户读取权限。
- 服务端需先执行：
CREATE OR REPLACE DIRECTORY ext_dir AS '/path/on/db/server'; GRANT READ ON DIRECTORY ext_dir TO your_user; -
OracleBfile只能在 Oracle JDBC 驱动（ojdbc8.jar或更高）中使用，不兼容标准java.sql.Blob接口 - 必须用
OracleConnection获取OracleBfile，不能从普通Connection强转——否则运行时报ClassCastException
如何正确获取并打开 OracleBfile 实例
核心是两步：从 ResultSet 中以 oracle.sql.BFILE 类型取出原始值，再调用其 openFile() 方法；跳过这一步直接调 getBinaryStream() 会失败。
- 确保 ResultSet 使用
getObject()并指定类型：OracleBfile bfile = (OracleBfile) rs.getObject("col_name", OracleBfile.class); - 必须显式调用
bfile.openFile()—— 这会触发与数据库服务端的交互，验证目录和文件是否存在、是否有权限 - 若文件不存在或权限不足，
openFile()抛出SQLException（如ORA-22288），不是在后续读取时才报 - 读取完成后务必调
bfile.closeFile()，否则可能泄漏服务端句柄
OracleBfile bfile = (OracleBfile) rs.getObject("doc_file", OracleBfile.class);
if (bfile != null && !bfile.isFileOpen()) {
bfile.openFile(); // 关键！
}
InputStream is = bfile.getBinaryStream();
// ... 处理流
bfile.closeFile(); // 关键！
OracleBfile.getBinaryStream() 返回的是只读、不可 reset 的流
它底层封装的是 Oracle 服务端发起的文件系统读取，不是 Java 端缓存。这意味着你无法反复读取、无法 mark()/reset()、也无法用 available() 准确判断长度（通常返回 0）。
- 如果需要多次处理（如校验 + 上传），必须先用
IOUtils.copy()或手动循环读到byte[]或ByteArrayOutputStream - 不要依赖
is.available() > 0判断是否为空 —— 它几乎总是 0；应检查bfile.fileExists()和bfile.length()（后者需服务端支持，且可能不准） - 大文件场景下，避免一次性
readAllBytes()，优先用带缓冲的流式处理，防止 OOM
常见错误：ORA-22285: file or directory does not exist
这个错误几乎都源于服务端配置问题，而非 Java 代码本身。Java 层看到的路径（如 ext_dir/myfile.pdf）是逻辑名，实际解析由 Oracle 数据库完成，与应用服务器所在机器无关。
- 确认
DIRECTORY对象路径在数据库服务器本地真实存在，且 Oracle 进程有读权限（Linux 下注意 SELinux / 文件属主） - 检查 BFILE 字段值是否为
DIR_NAME/FILE_NAME格式，且大小写与服务端一致（Linux 文件系统区分大小写） - 不要在 Java 中拼接绝对路径传给 BFILE；BFILE 值必须严格匹配
DIRECTORY名 + 斜杠 + 文件名 - 调试时可在 SQL*Plus 中执行：
SELECT BFILENAME('EXT_DIR', 'myfile.pdf') FROM DUAL;看是否报错
openFile() 调用那一刻由 Oracle 完成，而不是在构造 OracleBfile 或执行 SQL 时。 
