Java调用Oracle包体必须用CallableStatement执行BEGIN...END;匿名PL/SQL块，而非CALL或EXECUTE；前者支持IN/OUT/IN OUT参数、异常处理及REF CURSOR，后者仅适用于无返回值简单过程且兼容性差。
Oracle Package 方法调用必须用 CALL 还是 EXECUTE？
java 里不能直接“调用” oracle 包体方法，本质是执行 pl/sql 块或存储过程调用语句。jdbc 驱动不识别 execute（那是 sql*plus 的命令），也不推荐裸写 call —— 它只支持无返回值的简单过程，且对 out 参数、复杂类型支持极差。
正确做法是用 CallableStatement 执行匿名 PL/SQL 块，比如：BEGIN pkg_name.proc_name(?, ?, ?); END;。这能统一处理 IN/OUT/IN OUT 参数、异常捕获、返回结果集等场景。
-
CALL语法仅适用于最简过程（无 OUT、无异常处理、无 RETURNING），且 Oracle JDBC 对其参数绑定行为不一致，容易在 19c+ 版本出错 -
EXECUTE在 Java 中完全无效，JDBC 会报ORA-00900: invalid SQL statement - 用
BEGIN ... END;匿名块是唯一可靠方式，兼容所有 Oracle 版本和包体结构
IN/OUT 参数怎么绑？registerOutParameter 的坑在哪？
Oracle 包体里常见 PROCEDURE p(x IN VARCHAR2, y OUT NUMBER, z IN OUT DATE) 这类混合参数。Java 绑定时，顺序、类型、注册时机必须严格匹配，否则抛 SQLException 或返回 null/0。
关键点不是“写了 register 就行”，而是：类型要按 Oracle JDBC 映射规则选（比如 Types.VARCHAR 对应 VARCHAR2，Types.NUMERIC 对应 NUMBER），且 registerOutParameter 必须在 execute() 之前、setXXX() 之后调用。
- IN 参数用
setString(1, "val")等设置，无需注册 - OUT 参数必须用
registerOutParameter(2, Types.NUMERIC)，索引从 1 开始，且类型必须和包体声明一致（如包里是NUMBER(10)，不能注册成Types.INTEGER） - IN OUT 参数先
setXXX()初始值，再registerOutParameter()，execute()后用getXXX(2)取回新值 - 如果包体参数是自定义类型（如
RECORD或OBJECT），Java 无法直绑，得改用STRUCT或转 JSON 字符串传入
调用带返回值的函数（FUNCTION）和返回结果集（REF CURSOR）的区别
Oracle 包体里函数（FUNCTION f RETURN VARCHAR2）和返回游标的存储过程（PROCEDURE p(r OUT SYS_REFCURSOR)）在 Java 里处理逻辑完全不同：前者用 registerOutParameter(1, Types.VARCHAR) + executeQuery()；后者必须用 Types.OTHER 注册，再用 getResultSet() 获取游标结果。
立即学习“Java免费学习笔记（深入）”；
最容易错的是把 REF CURSOR 当成普通 OUT 参数取值 —— getString(1) 会返回 null，因为游标本身不是数据，是句柄。
- 函数返回标量值：用
executeQuery()，然后rs.next(); rs.getString(1) - REF CURSOR 输出：注册为
Types.OTHER，execute()后立刻调getResultSet()，不能用getString()或getInt() - 多个 REF CURSOR（如
p(out1 OUT SYS_REFCURSOR, out2 OUT SYS_REFCURSOR)）需按顺序调getResultSet()两次，且第二个结果集必须在第一个关闭后才能获取（否则报ORA-01001: invalid cursor）
字符集、日期格式、NULL 处理这些隐性依赖怎么稳住？
Java 调 Oracle 包体时，看似没报错，但数据错乱（如中文变问号、日期少 8 小时、NULL 被当成空字符串）—— 这些问题几乎都来自连接层配置和 JDBC 驱动默认行为，跟包体语法无关。
Oracle 客户端字符集（NLS_LANG）在 Java 里由 JDBC URL 和驱动自动协商，但若数据库用 ZHS16GBK，而 Java 默认 UTF-8，就可能触发隐式转换失败。日期同理：DATE 类型在 Java 里映射为 java.sql.Date，但 Oracle 的 DATE 实际含时分秒，用错类型会截断时间。
- JDBC URL 加
?useUnicode=true&characterEncoding=UTF-8没用，Oracle 驱动不认这个；正确做法是确保数据库NLS_LANGUAGE/NLS_TERRITORY和 JVMfile.encoding一致，或显式设connection.setClientInfo("oracle.jdbc.defaultNChar", "true") - 传日期优先用
java.time.LocalDateTime+setObject(idx, ldt, Types.TIMESTAMP)，避免用java.util.Date或字符串拼接 - Oracle 的 NULL 和 Java 的
null行为一致，但注意：IN 参数传null是允许的；OUT 参数若未被 PL/SQL 赋值，JDBC 返回仍是null，不是默认值
包体本身没魔法，所有“调用失败”背后都是参数绑定错、类型不匹配、或连接环境漂移。盯住那几个 registerOutParameter 的类型和顺序，比反复改 PL/SQL 更有效。
