Java调用Oracle存储函数必须用CallableStatement并声明OUT参数，SQL格式为{? = call func_name(?,?)},首个registerOutParameter(1, type)对应返回值，IN参数按序setXXX()，且需正确映射JDBC类型、驱动版本及权限。
CallableStatement调用Oracle存储函数必须带OUT参数声明
oracle的存储函数不能像sql server那样直接用select func_name(...) from dual在preparedstatement中执行——java jdbc要求显式声明函数返回值为out参数。否则会报ora-06550: pls-00221: 'xxx' is not a procedure or is undefined，哪怕函数本身语法完全正确。
实操要点：
- SQL字符串必须以
{? = call func_name(?, ?, ...)}格式书写，开头?代表返回值占位符 - 第一个
registerOutParameter(1, Types.XXX)必须对应这个返回值，位置索引从1开始 - 所有IN参数仍需按顺序调用
setXXX()，位置严格对齐SQL中的? - Oracle函数返回类型要映射到JDBC类型：比如
VARCHAR2→Types.VARCHAR，NUMBER→Types.NUMERIC或Types.DECIMAL
Oracle 19c下TIMESTAMP和CLOB返回值的特殊处理
Oracle 19c默认启用ENABLE_PLSQL_WARNINGS且对大对象更严格，若函数返回TIMESTAMP WITH TIME ZONE或CLOB，直接用getString(1)会抛SQLException: Invalid column type。
正确做法：
-
TIMESTAMP类：用getTimestamp(1)；带时区的必须用getTimestamp(1, Calendar.getInstance(TimeZone.getTimeZone("UTC")))显式传入时区上下文 -
CLOB：先getClob(1)拿到Clob对象，再调用clob.getSubString(1, (int) clob.length())读取内容；避免直接getString() - 若函数返回
BOOLEAN（PL/SQL原生类型），Oracle JDBC不支持，必须改写函数用NUMBER(1)或VARCHAR2(1)代替
连接URL和驱动版本不匹配导致的隐性失败
用ojdbc8.jar连Oracle 19c没问题，但若误用ojdbc6.jar，即使连接成功、CallableStatement创建不报错，执行executeQuery()时可能静默返回空结果或NullPointerException——因为旧驱动无法正确解析19c增强的元数据描述。
立即学习“Java免费学习笔记（深入）”；
检查项：
- 确认Maven依赖是
com.oracle.database.jdbc:ojdbc8:21.10.0.0或更高（19c官方推荐最低版本） - JDBC URL中建议显式添加
?oracle.jdbc.javaNetNio=false，禁用NIO通道，避免19c某些补丁版本下的socket阻塞 - 函数所在schema必须对数据库用户有
EXECUTE权限，仅SELECT不够；若跨schema调用，SQL里写全名：{? = call my_schema.my_func(?)}
完整可运行示例（含异常防护）
String sql = "{? = call get_employee_name(?)}";
try (CallableStatement cs = conn.prepareCall(sql)) {
cs.registerOutParameter(1, Types.VARCHAR); // 返回值
cs.setString(2, "EMP001"); // IN参数
cs.execute();
String name = cs.getString(1); // 此处才真正获取返回值
System.out.println(name);
} catch (SQLException e) {
if ("6550".equals(e.getSQLState())) {
// ORA-06550：检查函数名拼写、schema权限、参数个数
}
throw e;
}
最易忽略的是：函数调用后必须先调用execute()或executeQuery()，之后才能取返回值；没执行就getString(1)会得到null，且无任何异常提示。
