Web SQL 不支持 XML 类型字段，XML 仅作 TEXT 存储且无结构校验；存前需 DOMParser+XMLSerializer 转义，查后需重新解析；推荐改用 JSON、IndexedDB 或服务端解析。
Web SQL 不支持直接存储 XML 类型字段
Web SQL 是基于 SQLite 的客户端数据库，它没有 XML 数据类型，所有数据都按 TEXT、INTEGER、REAL、BLOB 等 SQLite 原生类型处理。你存的 XML 实际上只是字符串——哪怕内容是格式良好的 <user><name>Alice</name></user>，数据库也完全不校验合法性或结构。
这意味着：
- 必须手动确保 XML 字符串合法（比如转义
、<code>>、&等，或用DOMParser+XMLSerializer预处理） - 无法用 SQL 查询 XML 内部节点（例如不能写
SELECT * FROM docs WHERE xml LIKE '%<status>active</status>%'—— 这种模糊匹配极不可靠，且无法利用索引） - 大 XML 文本可能触发 Web SQL 的单条语句长度限制（尤其在旧版 Safari/iOS 中，
executeSql对参数长度敏感）
存 XML 前必须做字符转义或序列化封装
直接把原始 XML 字符串传给 INSERT 会出问题：如果 XML 含单引号（'）、双引号（"）或未转义的 &，会导致 SQL 语法错误或注入风险。不要拼接 SQL 字符串。
正确做法是使用参数化查询，并确保输入已是安全字符串：
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记（深入）”；
- 若 XML 来自用户输入或外部接口，先用
DOMParser解析再用XMLSerializer序列化，可自动处理转义：const parser = new DOMParser(); const doc = parser.parseFromString(userInput, 'application/xml'); if (doc.documentElement.nodeName === 'parsererror') throw new Error('Invalid XML'); const serializer = new XMLSerializer(); const safeXml = serializer.serializeToString(doc); - 若 XML 已是字符串且确定结构简单，可用正则或
String.replace()手动转义（仅作备用）：xmlStr.replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>').replace(/"/g, '"').replace(/'/g, ''');
- 插入时严格使用 ? 占位符：
tx.executeSql('INSERT INTO xml_docs (id, content, created) VALUES (?, ?, ?)', [id, safeXml, Date.now()]);
查 XML 后需重新解析才能操作节点
从 Web SQL 读出的 XML 是纯 TEXT 字段值，不是 DOM 对象。想取 <title></title> 或判断 <status></status> 是否为 done，必须手动解析：
- 用
DOMParser是最兼容的方式（所有现代浏览器支持）：const parser = new DOMParser(); const xmlDoc = parser.parseFromString(row.content, 'application/xml'); if (xmlDoc.querySelector('parsererror')) { console.error('XML parse error in record', row.id); } else { const title = xmlDoc.querySelector('title')?.textContent; } - 避免用
innerHTML或eval处理 XML 字符串——既不安全，也无法保证命名空间或 CDATA 正确处理 - 注意：
parseFromString第二个参数必须是'application/xml'（不是text/xml或空字符串），否则某些浏览器（如旧 Edge）会降级为 HTML 解析，破坏 XML 语义
替代方案比硬存 XML 更可靠
除非业务强依赖 XML 格式（如对接遗留 SOAP 接口、需保留注释/命名空间/CDATA），否则应优先考虑其他方式：
- 存为 JSON：前端天然支持
JSON.parse()/JSON.stringify()，体积更小，查询字段可拆到独立列（如status TEXT,updated INTEGER），支持索引和 WHERE 条件 - 用 IndexedDB 存 Blob：对超大 XML（>5MB），Web SQL 易达上限；IndexedDB 支持原生
Blob存储，且无同源 SQL 大小限制 - 服务端代理解析：把 XML 解析逻辑放到后端，前端只存结构化字段，规避所有客户端 XML 处理陷阱
Web SQL 本身已是废弃标准（Chrome 123+ 移除，Safari 仍支持但无更新），现在还用它存 XML，等于在技术债上叠技术债——真正难的从来不是“怎么存”，而是“以后怎么安全、高效地读和改”。
