fast-xml-parser 解析失败主因是输入非法XML或含BOM/注释/DOCTYPE等默认不支持内容；需按需配置ignoreDeclaration、ignoreComment等选项，并注意parseTagValue/parseAttributeValue对结构的影响。
fast-xml-parser 解析 XML 字符串失败，返回空对象或报错
常见原因是输入不是合法 XML，或含 BOM、注释、DOCTYPE 等 fast-xml-parser 默认不处理的内容。它默认只解析标准格式的 XML，且不支持 DTD 和 CDATA（除非显式开启）。
- 检查原始字符串是否以
开头，或至少以console.log(JSON.stringify(xmlStr.slice(0, 50)))看前 50 字符，确认无隐藏 BOM（如\uFEFF） - 若 XML 含注释（
），需启用ignoreDeclaration: false和ignoreAttributes: false，并设ignoreComment: false - 若含
/code>，必须设ignoreDeclaration: true（否则直接抛Invalid XML: DOCTYPE is not supported）
const { parse } = require('fast-xml-parser');
const options = {
ignoreAttributes: false,
ignoreDeclaration: true,
ignoreComment: false,
ignoreCdata: false,
parseTagValue: true,
parseAttributeValue: true
};
const result = parse(xmlString, options); // 不再因注释/DOCTYPE 崩溃如何保留 XML 中的属性和文本混合结构
fast-xml-parser 默认把属性转成带 @_ 前缀的键，文本内容则放在 #text 键下。但若没开 parseTagValue 和 parseAttributeValue，所有值都会是字符串，无法区分属性与子节点文本。
- 设
parseTagValue: true才会把纯文本子节点（如Alice - 设
parseAttributeValue: true才能把id解析为{ "@_id": "123" }，否则属性被完全忽略 - 若需扁平化（如把
@_id直接变id），得后处理：遍历对象，用Object.keys().filter(k => k.startsWith('@_'))提取并重命名
解析大文件时内存溢出或卡死
fast-xml-parser 是纯内存解析器，不支持流式（streaming）或 SAX 模式。XML 超过几 MB 就可能触发 Node.js 内存限制（默认 1.4GB），尤其当启用了 ignoreAttributes: false 生成大量嵌套对象时。
MyBatis3.2.3帮助文档 中文CHM版
下载
MyBatis 是支持普通 SQL 查询,存储过程和高级映射的优秀持久层框架。MyBatis 消除 了几乎所有的 JDBC 代码和参数的手工设置以及结果集的检索。MyBatis 使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plan Old Java Objects,普通的 Java 对象)映射成数据库中的记录。有需要的朋友可以下载看看
- 用
process.memoryUsage().heapUsed / 1024 / 1024监控解析前后内存变化 - 对 >2MB 的 XML，优先考虑改用
sax或libxmljs这类流式库；若必须用fast-xml-parser，先用fs.readFileSync读取后做简单校验（如统计出现次数），避免无效大文件进解析流程 - 禁用不必要的选项：如确定无属性，设
ignoreAttributes: true可减少 30%+ 对象创建量
从 JSON 再序列化回 XML 时格式错乱或丢失信息
fast-xml-parser 的 render 方法不保证 round-trip 精确还原：它不会保留原始缩进、换行、属性顺序，且对 #text 和 @_ 键的处理有隐含规则。
- 若源 XML 有同名兄弟节点（如多个
render时不会自动补成数组，导致结构不一致 - 解决办法：解析后统一用
Array.isArray(obj.item) ? obj.item : [obj.item]规范化，再传给render -
render不处理undefined值，但会把null渲染为JSON.parse(JSON.stringify(obj, (k, v) => v == null ? undefined : v))
const { render } = require('fast-xml-parser');
const normalized = {
root: {
item: Array.isArray(parsed.root.item)
? parsed.root.item
: [parsed.root.item]
}
};
const xmlOut = render(normalized); // 避免单元素 vs 多元素歧义解析 XML 的边界比看起来多：BOM、属性命名、兄弟节点数量、内存模型、序列化语义——这些点不提前对齐，调试时容易陷入“为什么这里没数据”的循环。
