Oracle函数必须有返回值，Java调用须用CallableStatement并以{? = call func_name(...)}语法注册返回参数，严格按位置绑定类型，NUMBER建议用getBigDecimal()避免精度丢失。
Oracle函数必须有返回值，Java要用CallableStatement而不是PreparedStatement
Oracle的函数（FUNCTION）和存储过程（PROCEDURE）在Java调用时处理方式不同：函数必须返回一个值，不能用PreparedStatement执行；必须用CallableStatement，且SQL语法要带{? = call ...}占位符。常见错误是写成call my_func(...)却没声明返回参数，导致SQLException: Invalid column index。
实操要点：
-
CallableStatement的SQL字符串必须以{? = call func_name(?, ?, ...)}开头，第一个?是返回值占位符 - 调用前必须用
registerOutParameter(1, sqlType)注册返回参数类型，比如Types.VARCHAR或Types.NUMERIC - Oracle函数参数名在Java里不生效，只按位置绑定，顺序必须和函数定义严格一致
- 如果函数返回自定义类型（如
OBJECT或REF CURSOR），需额外配置OracleConnection并注册STRUCT或ResultSet类型
返回值类型匹配错会导致SQLException: Cannot convert to internal representation
Oracle函数声明的返回类型（比如NUMBER、VARCHAR2、DATE）必须和Java中getXXX()方法及registerOutParameter()指定的SQL类型严格对应。尤其注意NUMBER——它可能映射为Integer、BigDecimal或Double，取决于精度；直接用getInt()取小数会丢精度甚至抛异常。
建议做法：
立即学习“Java免费学习笔记（深入）”；
- 查清函数定义：
SELECT data_type, data_precision, data_scale FROM all_arguments WHERE object_name = 'MY_FUNC' AND position = 0（position=0表示返回值） - 对
NUMBER统一用getBigDecimal()，再转成所需类型 - 对
DATE用getTimestamp()，避免时区问题；OracleDATE实际包含时间部分 - 对
BOOLEAN——Oracle原生不支持，函数若用1/0模拟，Java端用getInt()判断
函数含IN OUT参数时，每个?都要单独registerOutParameter()
Oracle函数本身不支持OUT参数（只有存储过程支持），但很多团队误把带OUT参数的过程当函数用，或者函数签名写成FUNCTION f(p1 IN NUMBER, p2 OUT VARCHAR2) RETURN NUMBER——这在Oracle语法上是非法的。真正合法的情况是：函数只能有IN参数，返回值唯一；若需多输出，应改用存储过程或返回RECORD/OBJECT。
但如果真遇到带OUT参数的“函数”（通常是DBA写的包装逻辑），说明它本质是过程，此时调用方式要改成{call proc_name(?, ?, ?)}，所有OUT和IN OUT参数都得调用registerOutParameter()，且索引从1开始按SQL中?顺序计数。
连接池环境下要注意Oracle驱动版本与ojdbc8.jar兼容性
旧项目用ojdbc6.jar调用含XMLTYPE或JSON返回值的函数时，会报ORA-00932: inconsistent datatypes——不是SQL写错，而是驱动不识别新类型。Java 8+项目必须用ojdbc8.jar，且需确认Oracle数据库版本（12c及以上才完整支持JDBC对JSON的映射）。
检查点：
- 运行时类路径中只能有一个
ojdbc*.jar，冲突会导致ClassCastException在getConnection()阶段就失败 - Spring Boot项目若用
spring-boot-starter-jdbc，需显式排除默认HikariCP自带的旧驱动，并引入com.oracle.database.jdbc:ojdbc8 - 函数返回
CLOB时，不要用getString()直接读——大文本可能被截断，应调用getClob().getSubString(1, (int) clob.length())
最易被忽略的是函数内部异常：Oracle函数里RAISE_APPLICATION_ERROR不会被Java静默吞掉，但错误码会被转成SQLException的getErrorCode()，比如-20001，需要主动捕获并解析，而不是只看getMessage()。
