必须使用getoraclexml()并配置xmltype=true连接参数，否则无法正确读取xmltype；中小xml用getxmlstring()，大xml需流式解析；写入须用oracledbtype.xml配合oraclexmltype实例。
直接调用 GetOracleXml() 是唯一可靠方式
Oracle Data Provider for .NET（ODP.NET）不支持原生 XMLType 映射，reader.GetValue() 或 reader.GetString() 会抛出 "不支持的 Oracle 数据类型 USERDEFINED"。必须显式使用 ODP.NET 提供的扩展方法 GetOracleXml() —— 它返回 OracleXmlType 实例，而非字符串或 byte[]。
这个方法只在 OracleDataReader 上可用，且要求连接字符串启用 XML 支持（见下文）。别试图用 GetFieldValue<object>()</object> 强转，那大概率触发 InvalidCastException。
- 确保引用的是 ODP.NET Core（
Oracle.ManagedDataAccess.Core）或新版 ODP.NET（≥ 21c），旧版（如 12.1）可能无此方法 - 字段名必须带表别名，例如
SELECT t.xml_col FROM my_table t，否则GetOracleXml("xml_col")可能找不到列 - 若字段为 NULL，
GetOracleXml()返回null，需判空：if (xml != null) { ... }
连接字符串必须加 XmlType=true
ODP.NET 默认把 XMLType 当作黑盒 USERDEFINED 类型处理。不加参数，GetOracleXml() 会直接返回 null，哪怕数据真实存在。
在连接字符串末尾追加：XmlType=true。完整示例："Data Source=…;User Id=…;Password=…;XmlType=true;"。这是硬性开关，缺一不可。
- 该参数仅影响读取行为，不影响写入；写入仍需用
OracleCommand.Parameters.Add()配合OracleDbType.Xml - 如果用连接池（如
OracleConnectionPool），该参数必须在池初始化时就设定，运行时修改无效 - 未加此参数时错误现象：不报异常，但
GetOracleXml()恒为null，极易误判为数据为空
中小 XML 用 xml.GetXmlString()，大 XML 必须流式读
OracleXmlType.GetXmlString() 会将整个 XML 加载为 string，适合小于 100 KB 的内容。超过此阈值，堆内存压力陡增，GC 频繁甚至 OOM。
对中大 XML（100 KB–5 MB），改用 xml.GetStream() 获取 Stream，再套 XmlReader.Create(stream) 流式解析。它不缓存全文，只按需读节点，内存占用稳定在几十 KB 级别。
-
GetStream()返回的流编码固定为 UTF-8，无需额外指定 Encoding - 别用
xml.Value或ToString()—— 前者可能截断，后者常返回类型名而非内容 - 超大 XML（> 5 MB）建议放弃 C# 端全量解析，改用 SQL 层
XMLTable提前拆成关系行，只拉关键字段
写入 XMLType 字段必须用 OracleDbType.Xml 参数
用 cmd.Parameters.AddWithValue("@xml", xmlStr) 或 cmd.Parameters.Add("@xml", xmlStr) 会触发 Oracle 隐式转换，超长内容（> 4000 字符）、含 BOM 或特殊控制字符时必报 ORA-01461。
正确流程分三步：var p = cmd.Parameters.Add("@xml", OracleDbType.Xml) → p.Value = new OracleXmlType(conn, xmlContent) → 执行命令。其中 xmlContent 必须是良构 XML（有根节点、标签闭合、UTF-8 编码、无 BOM）。
-
OracleXmlType构造函数第二个参数是string，不是Stream或XmlDocument；若 XML 来自文件，先读成 string 再传入 - 若 XML 含命名空间，确保声明格式合法（如
<root xmlns="http://ns"></root>），否则写入时可能被静默截断 - 不推荐用
cmd.Parameters.Add("@xml", OracleDbType.Clob)替代 —— CLOB 不校验 XML 结构，后续 XPath 查询易失败
C# 解析 Oracle XMLType 的核心陷阱不在语法，而在驱动行为与连接配置的耦合性：XmlType=true 是开关，GetOracleXml() 是入口，其余全是围绕内存和结构合法性的防御动作。漏掉任一环，问题都表现为“读不到”或“读出来是空”，而不是明确异常。
