Oracle自定义对象类型在Java中无法直接映射为普通POJO，JDBC原生不支持自动反序列化，ResultSet.getObject()返回oracle.sql.STRUCT而非自定义类；强行cast抛ClassCastException，需用STRUCT.toJdbc()手动提取字段或注册SQLData接口实现类型映射。
Oracle自定义对象类型在Java中无法直接映射为普通POJO
Java JDBC原生不支持Oracle OBJECT 类型的自动反序列化，调用 ResultSet.getObject() 会返回 oracle.sql.STRUCT 实例，而非你定义的 Java 类。强行 cast 成自定义类会抛 ClassCastException；忽略类型直接 toString() 又拿不到结构化字段值。
根本原因在于：Oracle 的 OBJECT 是数据库端的复合类型（类似 struct），JDBC 驱动只提供底层二进制/描述符封装，不负责 Java 端建模。
实操建议：
- 必须引入 Oracle 官方 JDBC 驱动（如
ojdbc8.jar），且版本需与数据库兼容（例如 Oracle 19c 推荐用 ojdbc8 19.22+） - 禁止依赖 Spring JDBC 或 MyBatis 的默认类型处理器——它们对
STRUCT无内置支持 - 不要尝试用 Jackson/Gson 直接解析
STRUCT.toString()，输出格式不稳定（含描述符头、十六进制字节等）
用 oracle.sql.STRUCT 手动提取字段值
oracle.sql.STRUCT 是唯一可靠的入口，它提供 toJdbc() 和 toJdbcArray()，但更常用的是 toJdbc() 返回 Object[]，按 Oracle 类型定义顺序排列字段值。
立即学习“Java免费学习笔记（深入）”；
示例：假设 Oracle 有 CREATE OR REPLACE TYPE person_t AS OBJECT (name VARCHAR2(50), age NUMBER)，Java 中调用：
STRUCT struct = (STRUCT) rs.getObject("person_col");
Object[] attrs = (Object[]) struct.toJdbc();
String name = (String) attrs[0];
Integer age = attrs[1] == null ? null : ((BigDecimal) attrs[1]).intValue(); // NUMBER → BigDecimal
注意点：
- 字段顺序严格匹配
CREATE TYPE中声明顺序，不能靠列名索引（struct.toJdbc()不支持 named lookup） - Oracle
NUMBER映射为java.math.BigDecimal，不是Integer或Long，需手动转换 - 嵌套
OBJECT或VARRAY字段会返回嵌套的STRUCT或ARRAY，需递归处理 - 若字段为 NULL，对应
attrs[i]为null，不可强转
注册自定义类型映射（可选，适合复用场景）
如果多个地方用到同一 OBJECT 类型，可通过 Connection.setTypeMap() 注册 Java 类映射，让 ResultSet.getObject() 返回你自己的 POJO 实例。
前提条件：
- 你的 Java 类必须实现
SQLData接口，并重写readSQL()和writeSQL() - 类名必须与 Oracle 类型名完全一致（大小写敏感），或通过
setTypeMap显式绑定 - 驱动需开启
oracle.jdbc.ReadImplicitTypes=true（JDBC URL 加参数）
关键代码片段：
Map<String, Class<?>> typeMap = conn.getTypeMap();
typeMap.put("SCHEMA.PERSON_T", Person.class); // 注意全大写 + schema前缀
conn.setTypeMap(typeMap);
// 此后 rs.getObject("person_col") 就返回 Person 实例
风险提示：
-
SQLData.readSQL()内部仍要调用stream.readObject()并手动转型，没省多少事 - 一旦 Oracle 类型变更（增删字段），所有
SQLData实现必须同步修改，否则运行时报SQLException: Fail to convert to internal representation - MyBatis 等框架可能绕过 typeMap，导致失效
遇到 ORA-00932 或 “inconsistent datatypes” 错误怎么办
这类错误几乎都源于 JDBC 层类型声明与 Oracle 实际类型不匹配。常见触发点：
- 调用
PreparedStatement.setObject(idx, obj, Types.STRUCT)时，obj不是STRUCT实例，而是普通 POJO - 使用
OraclePreparedStatement.setSTRUCT()但传入的STRUCT对应的ORAData描述符与数据库类型不一致（如 schema 名写错） - PL/SQL 存储过程中接收
OBJECT参数，但 Java 端未用OracleCallableStatement.registerOutParameter()正确注册类型
排查步骤：
- 确认 Oracle 类型全名（含 schema）：查
ALL_TYPES视图，如SELECT owner, type_name FROM ALL_TYPES WHERE type_name = 'PERSON_T' - 构造
STRUCT时必须用new STRUCT(descriptor, connection, values)，其中descriptor由StructDescriptor.createDescriptor("SCHEMA.PERSON_T", conn)创建 - 存储过程调用务必显式注册：
ocs.registerOutParameter(1, OracleTypes.STRUCT, "SCHEMA.PERSON_T")
最易被忽略的是 descriptor 的 schema 名大小写和连接用户权限——即使类型存在，若当前连接用户无 EXECUTE 权限，StructDescriptor.createDescriptor() 会静默失败，后续操作全崩。
