Java中处理Oracle结构化类型必须使用官方ojdbc驱动（如ojdbc8.jar），依赖oracle.sql.STRUCT等类，不可靠反射自动映射；需显式引入驱动、配置JDK9+模块参数，通过rs.getObject获取STRUCT并结合元数据或命名映射填充自定义Java Bean。
必须用官方 Oracle JDBC 驱动
MySQL、PostgreSQL 等不支持 SQL 结构化类型，只有 Oracle 官方驱动（ojdbc8.jar 或 ojdbc11.jar）提供 oracle.sql.STRUCT、oracle.sql.ARRAY、oracle.sql.REF 等类。HikariCP、Spring Boot 默认嵌入的驱动通常不含这些类——必须显式引入对应版本的 ojdbc JAR，并确保它在 classpath 顶端。
JDK 9+ 用户还需添加启动参数：--add-opens java.base/java.lang=ALL-UNNAMED
否则 oracle.sql.STRUCT 可能被模块系统屏蔽，导致 ClassNotFoundException。
从 ResultSet 获取 STRUCT 并识别类型
查询含自定义对象类型的列时，不能用 rs.getString("xxx")，必须用：
STRUCT struct = (STRUCT) rs.getObject("person_obj");- 调用
struct.getSQLTypeName()获取完整类型名（如"HR.PERSON_TYPE"），用于匹配 Java Bean 类 - 调用
struct.toJDBCObject(connection)返回Object[]，数组元素顺序严格对应 Oracle 类型定义中字段声明顺序（不可靠），更稳妥的是结合元数据或命名映射
用反射填充 Java Bean（非 Oracle 内部类）
你真正要加载和操作的是自己的 Bean 类，比如 com.example.Person，不是 oracle.sql.STRUCT：
- 通过
Class.forName("com.example.Person")加载目标类，创建实例 - 遍历其所有声明字段：
field.setAccessible(true) - 按字段名匹配：将 Oracle 字段名（如
"first_name"）转为驼峰（"firstName"），再与 Java 字段名比对 - 对嵌套 STRUCT，递归调用相同逻辑；对 ARRAY 或 NESTED TABLE，先转为
ARRAY实例，再逐项取STRUCT并映射 - 注意循环引用风险——若对象图存在双向关联，需加缓存或标记机制防止栈溢出
不推荐序列化方案
把自定义类型整个序列化成 BLOB 存储再反序列化，看似绕过 UDT 限制，但实际丧失了数据库端的类型语义、索引能力、SQL 查询能力（无法 WHERE person_obj.name = 'Tom'），仅适用于极简场景。Oracle 原生 UDT 支持才是正解。
立即学习“Java免费学习笔记（深入）”；
