Java调用Oracle存储过程时，TABLE类型参数必须用createARRAY而非createStruct，因后者仅支持OBJECT类型；需通过OracleConnection.createARRAY("STR_LIST", elements)构造，elements为Object[]且不可为null。
java 调用 oracle 存储过程时，若入参是自定义的 table 类型（如 create type str_list as table of varchar2(100)），不能直接传 list<string></string>，必须通过 oracleconnection.createstruct 配合 array 构造——但注意：createstruct 本身不用于 table，真正要用的是 createarray；createstruct 是给 object 类型准备的。
为什么不能用 createStruct 传 TABLE 类型？
createStruct 只能构造 Oracle 的 OBJECT 类型（对应 Java 的 STRUCT），而 TABLE 类型在 JDBC 中映射为 oracle.sql.ARRAY。强行用 createStruct 去塞一个表类型，会抛出 java.sql.SQLException: invalid name pattern 或 ORA-04043: object ... does not exist ——因为驱动找不到匹配的 OBJECT 定义。
-
TABLE类型 → 必须用connection.createARRAY(typeName, elements) -
OBJECT类型（如CREATE TYPE person AS OBJECT(...)）→ 才用connection.createStruct(typeName, values) - type name 必须与数据库中大小写完全一致（通常是大写），且用户有权限访问该类型
如何正确构造并传递 TABLE 类型参数？
核心步骤：获取原生 OracleConnection → 调用 createARRAY → 注册为 Types.ARRAY → 设置到 CallableStatement。
- 确保使用
ojdbc8.jar（或对应版本），且驱动支持你定义的集合类型 - type name 写全称：
"SCHEMA_NAME.STR_LIST"（如果类型在当前用户下，可省略 schema，但显式写出更稳） - 元素数组必须是 Object[]，即使元素是 String，也不能用 String[] 直接传（JDBC 驱动内部校验类型）
- 空集合不能传
null，应传new Object[0]，否则报NullPointerException在createARRAY内部
String[] values = {"a", "b", "c"};
Object[] elements = Arrays.stream(values).map(Object.class::cast).toArray(); // 确保是 Object[]
ARRAY array = ((OracleConnection) connection).createARRAY("STR_LIST", elements);
callableStatement.setArray(1, array);
常见报错及定位方法
遇到失败，优先检查这三处：
-
ORA-00904: "XXX": invalid identifier→ 存储过程中引用了不存在的字段名，和 ARRAY 无关，先查 SP 定义 -
ORA-04043: type STR_LIST does not exist→ type name 拼错、大小写不对、或当前连接用户无EXECUTE权限（GRANT EXECUTE ON STR_LIST TO your_user） -
java.lang.ClassCastException: oracle.jdbc.driver.T4CConnection cannot be cast to oracle.jdbc.OracleConnection→ 连接被代理（如 Spring DataSourceUtils 获取的连接），需用unwrap(OracleConnection.class)替代强转
Spring Boot + MyBatis 场景下的注意事项
MyBatis 默认不暴露原生 OracleConnection，若用 SqlSession 调用存储过程，需手动 unwrap：
立即学习“Java免费学习笔记（深入）”；
- 从
DataSource获取连接后，调用unwrap(OracleConnection.class) - 不要依赖
@SelectProvider或 XML 中的{mode=IN, jdbcType=OTHER}自动处理 ARRAY —— 它不识别自定义集合类型 - 若用 Spring
JdbcTemplate，需配合SqlOutParameter和自定义SqlTypeValue实现setTypeValue方法来构造ARRAY
最易忽略的一点：Oracle 的 TABLE 类型在不同 session 间不可跨 schema 引用，即使 public synonym 存在，createARRAY 仍要求 typeName 精确匹配创建时的 schema + 名称。别信“同义词能自动解析”这种直觉。
