Java反射无法直接映射Oracle自定义类型，需依赖JDBC驱动支持；Class.forName("oracle.sql.STRUCT")抛异常是因类路径缺失或驱动版本不匹配；应加载自定义Bean类而非Oracle内部类，再通过反射匹配字段名填充，嵌套类型需手动递归处理并防循环引用。
java反射本身不能直接映射oracle的复杂自定义对象类型（比如 object、varray、nested table），它只负责在运行时获取类结构；真正起作用的是 jdbc 驱动对 oracle 自定义类型的序列化/反序列化支持，反射只是配合完成类型发现和字段填充。
为什么 Class.forName("oracle.sql.STRUCT") 会抛 ClassNotFoundException？
这不是反射的问题，而是类路径缺失或驱动版本不匹配。Oracle 的自定义类型支持依赖 ojdbc8.jar（JDK 8+）或 ojdbc11.jar（JDK 11+），且必须包含 oracle.sql.* 和 oracle.jdbc.oracledriver 包。
- 确认你用的是官方 Oracle JDBC 驱动，不是 HikariCP 或 Spring Boot 自带的默认驱动（它们通常不含 Oracle 特有类型支持）
-
oracle.sql.STRUCT类在ojdbc8.jar中存在，但 JDK 9+ 模块系统可能屏蔽它；需显式添加--add-opens java.base/java.lang=ALL-UNNAMED启动参数 - 别用
Class.forName("oracle.sql.STRUCT")去“加载类型”——你真正要加载的是你自己的 Java Bean 类，比如Person.class，而不是 Oracle 内部类
如何用反射把 STRUCT 字段转成 Java 对象？
核心是：先让 JDBC 返回 oracle.sql.STRUCT 实例，再用反射按字段名/顺序匹配 Java Bean 的 setter 或字段。
- 从
ResultSet获取 STRUCT：STRUCT struct = (STRUCT) rs.getObject("person_obj")，注意字段名必须与 Oracle 类型定义一致（大小写敏感） -
struct.toJDBCObject(conn)返回Object[]，每个元素对应 Oracle 类型的一个属性值（顺序固定，不可靠）；更稳妥的是调用struct.toJDBCObject(conn)后，用struct.getSQLTypeName()确认类型名，再查映射表 - 用反射填充目标对象：
Class> beanClass = Class.forName("com.example.Person")，然后遍历beanClass.getDeclaredFields()，对每个字段尝试调用field.setAccessible(true)并赋值——但注意 Oracle 字段名可能含下划线（如first_name），而 Java 字段是firstName，需做驼峰转换 - 不要硬编码 setter 调用顺序；优先用字段名匹配（
field.getName().equalsIgnoreCase(oracleColumnName)），否则容易因 Oracle 类型字段顺序变更而失败
嵌套对象（如 OBJECT 包含 VARRAY）怎么递归处理？
反射不自动递归，必须手动识别并分层处理。Oracle 的嵌套结构在 JDBC 层表现为 oracle.sql.ARRAY、oracle.sql.STRUCT 或 oracle.sql.REF，它们都继承自 oracle.sql.Datum。
- 拿到
oracle.sql.ARRAY后，调用array.getArray()得到Object[]，每个元素可能是STRUCT、ARRAY或基础类型；对每个元素判断类型，再决定是否递归调用同一套反射填充逻辑 - 遇到
oracle.sql.REF，需先调用ref.getValue()获取实际对象，再走 STRUCT 流程；否则会空指针 - 避免无限递归：检查当前深度，或记录已处理的
STRUCT地址（System.identityHashCode(struct)），防止循环引用（如父子关系）导致栈溢出 - 性能敏感场景下，别每层都重新
getDeclaredFields()；可提前缓存字段映射关系（Map<string field></string>），按 Oracle 类型名索引
最易被忽略的一点：Oracle 自定义类型名（如 PERSON_T）在 JDBC 中是全大写且带 schema 前缀（"SCHEMA.PERSON_T"），而 Java 类名是小写包名加驼峰类名；这个字符串映射必须显式维护，反射无法自动推断。
立即学习“Java免费学习笔记（深入）”；
