Java 17下解析Oracle XMLType字段必须用getSQLXML()（ojdbc21唯一支持），中小XML用getCharacterStream()流式读；ojdbc8可用getObject()+XMLType但需xdb6.jar依赖；写入一律用setSQLXML()，禁用setString()。
Java 17 下解析 Oracle XMLType 字段，**必须绕开 getString()，优先用 getSQLXML() 或 getObject() + XMLType，具体选哪个取决于驱动版本和 XML 大小——ojdbc21 只认前者，ojdbc8 两者都行但行为不同。**
用 getSQLXML() 是 Java 17 + ojdbc21 的唯一正路
ojdbc21（Oracle JDBC 21）已彻底删除 oracle.xdb.XMLType 类，所有 import 和调用都会编译失败。此时 getSQLXML() 是标准且唯一受支持的方式。
-
rs.getSQLXML("col")返回java.sql.SQLXML实例，JDBC 4.2+ 规范定义，Java 17 原生兼容 - 字段为 NULL 时返回
null，必须判空：if (sqlXml != null) { ... } - 中小 XML（sqlXml.getString() 最快；别在
ResultSet上调getString()，那会返回null或乱码 - 大 XML（> 100KB）改用
sqlXml.getCharacterStream()配BufferedReader流式读，避免堆内存爆炸 - 别碰
sqlXml.getBinaryStream()后自己解码——Oracle 固定 UTF-8，字符流更安全
用 getObject() + XMLType 仅限 ojdbc8 / ojdbc11 场景
如果你还在用 ojdbc8（对应 Oracle 12c–19c），getObject() 仍可返回 oracle.xdb.XMLType 实例，但它不是标准 JDBC 类型，需额外依赖 xdb6.jar。
- 必须显式引入 Maven 依赖：
com.oracle.database.xml:xdb6，否则运行时报NoClassDefFoundError - 获取字符串应调
xmlType.getStringVal()，不是toString()或getString()—— 后者可能截断或抛异常 -
xmlType.getDOM()可直出org.w3c.dom.Document，底层走xmlparserv2.jar，避免字符串中转，但要注意类路径冲突（如 Xerces 冲突导致ClassCastException） - 连接池（如 HikariCP）要加参数
oracle.jdbc.xmltype=true，否则getObject()可能返回byte[]而非XMLType
写入 XMLType 字段：一律用 setSQLXML()，禁用 setString()
ps.setString(1, xmlStr) 看似能执行，实则触发 Oracle 隐式转换，超长内容（> 4000 字符）、含特殊字符或 BOM 的 XML 必崩，报 ORA-01461。
立即学习“Java免费学习笔记（深入）”；
- 正确流程：先
conn.createSQLXML()创建空对象 →sqlXml.setString(xmlContent)填值（确保良构、UTF-8、无 BOM）→ps.setSQLXML(1, sqlXml) - 若 XML 来自文件或 HTTP 响应，优先用
sqlXml.setCharacterStream()接InputStream，避免内存拼接大字符串 - ORM 框架（MyBatis/Hibernate）不原生支持 XMLType，必须自定义
TypeHandler或在 SQL 层用XMLTable提前拆解成关系列
性能陷阱：别在 Java 里解析整棵 XML，优先推给 SQL 层
真正影响效率的从来不是 Java 解析器，而是 XML 存储方式和查询写法。Java 端加载 10MB XML 到内存，GC 都来不及跑完。
- 查之前先确认表定义：
SELECT storage_type FROM user_xml_tables WHERE table_name = 'YOUR_TABLE'，BINARY XML比CLOB快一个数量级 - 多值提取别用
EXTRACTVALUE（已废弃），改用XMLTable+XMLNAMESPACES，它生成关系行，可走索引、可JOIN、可WHERE - 单值场景用
XMLCast(XMLQuery('/path/text()' PASSING doc RETURNING CONTENT) AS VARCHAR2(100))，比extractValue()更稳且索引友好 - 真要 Java 处理，也只取必要片段：SQL 层先
XMLQuery('/root/item[1]' PASSING doc RETURNING CONTENT)，再传给 Java
最易被忽略的一点：XMLType 不是字符串类型，它的行为由驱动版本、存储方式、JDBC 规范三者共同决定。ojdbc21 和 ojdbc8 的 API 表面相似，底层实现完全不同——别复用旧项目代码，先看驱动版本再动手。
