Java调用Oracle 19c存储过程时，CallableStatement参数类型必须严格对齐PL/SQL声明，错配会导致运行时报错或静默截断；需按data_type查定义、用Oracle类型常量注册、正确处理REF CURSOR和时区类型，并规范CLOB/BLOB操作。
Java调用Oracle 19c存储过程时，CallableStatement的参数类型必须与PL/SQL声明严格对齐
oracle 19c本身不校验jdbc传入的java类型是否“语义匹配”，但错配会导致运行时报错或静默截断——比如把varchar2当成number注册，或把date当成timestamp。关键不是“能跑通”，而是“结果可信”。
实操建议：
- 查清存储过程定义：用
SELECT argument_name, data_type, in_out FROM all_arguments WHERE object_name = 'YOUR_PROC' ORDER BY position确认每个参数的data_type和方向（IN/OUT/IN OUT） -
registerOutParameter()必须用Oracle类型常量，不是Java类型：例如Types.VARCHAR对应VARCHAR2，Types.DATE对应DATE，Types.TIMESTAMP对应TIMESTAMP；别用Types.INTEGER去接NUMBER(1)，应优先用Types.DECIMAL并设精度 - 输入参数用
setXXX()时，注意Oracle对空值的敏感：对NUMBER列传null要用setNull(index, Types.NUMERIC)，不能只写setNull(index, Types.INTEGER)，否则可能触发ORA-01008
处理OUT参数为REF CURSOR时，必须用ResultSet接收且不能提前关闭
这是最常出问题的场景：Java里误把REF CURSOR当普通输出参数，调用getXXX()报SQLException: Invalid column type。
实操建议：
- 注册时必须用
Types.OTHER：cs.registerOutParameter(2, Types.OTHER) - 执行后立刻用
cs.getObject(2)获取ResultSet，不要用cs.getResultSet()（它只对隐式游标有效） - 该
ResultSet生命周期绑定到CallableStatement，一旦cs.close()，游标在数据库端即关闭，后续再调用rs.next()会抛SQLException: Closed Connection - 如果需多次遍历，必须在
rs打开期间复制数据到内存集合（如List<map object>></map>），不能保留ResultSet引用
日期时间类参数要区分DATE、TIMESTAMP和TIMESTAMP WITH TIME ZONE
Oracle 19c默认DATE只有秒级精度且无时区，而Java 8+的LocalDateTime、ZonedDateTime语义不同。错配不会编译报错，但入库值可能被截断或偏移。
实操建议：
- 对应
DATE：用java.sql.Date（仅年月日）或java.sql.Timestamp（带时分秒，Oracle自动忽略纳秒）；避免用LocalDateTime直接set，需转成Timestamp.valueOf() - 对应
TIMESTAMP：必须用java.sql.Timestamp，且注意Timestamp构造函数传毫秒值时，Oracle默认按JVM本地时区解释，建议统一用UTC时间戳 + 显式时区转换 - 对应
TIMESTAMP WITH TIME ZONE：JDBC驱动要求用oracle.sql.TIMESTAMPTZ（非标准JDBC类型），需先通过conn.createTIMESTAMPTZ()创建实例，传入ZoneId和Instant；别试图用setObject(idx, zdt, Types.OTHER)绕过，会丢失时区信息
大对象（CLOB/BLOB）参数不能直接用setString()或setBytes()
看似能写入，但超过约4KB后大概率触发ORA-01461: can bind a LONG value only for insert into a LONG column——这是Oracle JDBC驱动对“大值”的隐式降级失败。
实操建议：
- 对
CLOB输入参数：用setClob(int parameterIndex, Reader reader, long length)，或先调用conn.createClob()生成临时CLOB，再用clob.setString(1, str)写入，最后cs.setClob(idx, clob) - 对
BLOB输入参数：同理，用conn.createBlob()+blob.setBytes(1, bytes)，再cs.setBlob()；别用setBinaryStream()除非数据源本身就是流 - 所有
CLOB/BLOB操作必须在同一个事务内完成，且CallableStatement未关闭前不能释放临时LOB句柄，否则可能报ORA-22275: invalid LOB locator specified
最容易被忽略的是REF CURSOR的资源绑定关系和TIME ZONE参数的显式构造——这两处出问题时现象隐蔽，日志里往往只报“无效的列类型”或“日期值不合法”，实际根源却在类型注册或时区转换环节。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
