oracle udt 映射失败主因是c#类未标记[oraclecustomtypemapping]、未实现ioraclecustomtype/ioraclecustomtypefactory，或udttypename大小写/全限定名不匹配；嵌套udt需逐层映射，避免混用oracleobject与自定义类，且须确保schema权限正确。
oracle udt 映射失败：oracleudt 类没实现或类型名不匹配
odp.net 要把 oracle 的 object type（比如 person_type）映射成 c# 类，必须让该类显式标记为 [oraclecustomtypemapping]，且实现 ioraclecustomtype 和 ioraclecustomtypefactory。只加个 public class person 是没用的，odp.net 完全不认识。
常见错误现象：System.InvalidOperationException: Unable to cast object of type 'Oracle.ManagedDataAccess.Types.OracleObject' to type 'YourNamespace.Person'
-
[OracleCustomTypeMapping("SCHEMA.PERSON_TYPE")]中的 schema 名必须全大写、与数据库中一致（哪怕你建的时候用了双引号小写，这里也得按实际存储名来） - 工厂类（实现
IOracleCustomTypeFactory）的CreateObject方法返回的实例，必须是你要映射的 C# 类型，不能是基类或接口 - 如果 UDT 在 public 同义词下，schema 名仍要写真实 owner，比如
"HR.PERSON_TYPE"，而不是"PUBLIC.PERSON_TYPE"
从 OracleCommand 获取 UDT 返回值时，OracleDbType.Object 必须配对指定 UdtTypeName
调用带 OUT 参数的存储过程，或查询返回 OBJECT 列时，不能只设 OracleDbType.Object，否则 ODP.NET 不知道该转成哪个 .NET 类——它会退化成 OracleObject，你拿不到强类型对象。
使用场景：执行 SELECT person_col FROM people WHERE id = 1，其中 person_col 是 PERSON_TYPE
- 参数/列必须显式设置
UdtTypeName = "SCHEMA.PERSON_TYPE"，例如：param.UdtTypeName = "HR.PERSON_TYPE" - 如果是查询结果集，DataReader 读取时也要先确认列的
OracleDbType是Object，再用GetOracleObject(i)，然后手动调用ToCustomObject<person>()</person>（需引用Oracle.ManagedDataAccess.Types） - 注意：
UdtTypeName区分大小写，且不能带引号；若类型在非默认 schema，必须写全限定名
嵌套 UDT 或集合（VARRAY/TABLE OF）导致反序列化崩溃
Oracle 的 OBJECT TYPE 字段里如果包含另一个 OBJECT TYPE，或定义了 MEMBER FUNCTION，ODP.NET 默认不会递归解析——它卡在第一层，抛出 NotSupportedException 或空引用。
性能影响：每层嵌套都会触发一次额外的元数据查询，深度 >3 层时延迟明显上升
- 嵌套对象字段必须也声明为对应 C# 类型，并同样实现
IOracleCustomType映射（不能用object或OracleObject） -
VARRAY或TABLE OF需额外注册集合映射：用[OracleCustomTypeMapping("SCHEMA.PERSON_LIST")]标记一个实现IOracleCollection的类，内部用List<person></person>存储 - 避免在 UDT 中定义
MEMBER FUNCTION或MAP MEMBER FUNCTION，ODP.NET 不调用它们，但可能干扰类型发现逻辑
使用 Oracle.ManagedDataAccess 时，OracleObject 与自定义类混用引发内存泄漏
开发中常误以为“先用 GetOracleObject() 拿到原生对象，再手工赋值给 C# 类”更安全，结果每次调用都创建未释放的 OracleObject 实例，长期运行后连接池耗尽、GC 压力陡增。
兼容性影响：.NET Core 3.1+ 上，OracleObject 的 finalizer 行为不稳定，某些版本会跳过清理
- 全程坚持用强类型映射路径：参数设
UdtTypeName→ 绑定自定义类实例 → 执行 → 直接接收返回的 C# 对象 - 绝不调用
GetOracleObject()后又丢弃它；如真需底层访问，用完立刻调用Dispose() - 检查项目是否同时引用了
Oracle.DataAccess（旧版）和Oracle.ManagedDataAccess，二者混用会导致类型系统冲突，映射直接失效
最麻烦的其实是 schema 权限和同义词链——UDT 映射失败十次里有七次不是代码问题，而是当前连接用户没被授予 EXECUTE 权限，或者 CREATE TYPE 时用了双引号导致名字大小写敏感，而 C# 里写的 UdtTypeName 没对上。
