xml转json时单子元素默认不生成数组，需显式配置强制转为数组：xmltodict用force_list、fast-xml-parser设arraymode:"always"、jackson用@jacksonxmlelementwrapper+@jacksonxmlproperty、jaxb加双注解。
XML单个子元素被忽略为数组的问题
XML转JSON时，<items><item>A</item></items> 常被转成 {items: {item: "A"}}，而不是预期的 {items: [{item: "A"}]}。这不是bug，是多数解析器默认按“出现次数=1就当对象、≥2才建数组”的启发式逻辑——但业务常要求统一为数组，尤其对接前端表格或循环渲染场景。
- 别依赖解析器自动推断：像
xml2js的explicitArray: false默认值就是陷阱，必须显式设为true - 即使只有一个
<item></item>，也要在 schema 或配置里声明它“可重复”，否则 JSON 结构不一致，前端map()会报错 - Java 用
JAXB时，字段需加@XmlElementWrapper+@XmlElement双注解，单元素才进 List
Python中用xmltodict强制单元素变数组
xmltodict 默认不处理单复数歧义，但支持通过 force_list 参数指定哪些标签必须转成 list，这是最轻量的解法。
- 传参
force_list=["item", "entry", "user"]，无论 XML 中出现几次，对应 key 的值都是 list - 注意路径匹配是标签名精确匹配，不支持通配符或 XPath，嵌套多层时要写全每级标签名（如
force_list=["root", "items", "item"]） - 如果 XML 有命名空间，
xmltodict会把 ns 转成@xmlns字段，可能干扰force_list匹配，建议先用正则剥离 namespace 再解析
import xmltodict
xml = "<root><items><item>x</item></items></root>"
data = xmltodict.parse(xml, force_list=["item"]) # → {"root": {"items": [{"item": "x"}]}}
JavaScript里用fast-xml-parser保持数组一致性
fast-xml-parser 比 xml2js 更可控，关键在 ignoreAttributes: false 和 parseTagValue: false 配合 arrayMode。
- 设
arrayMode: "strict"后，只有带multiple="true"属性的标签才进数组——但这得改原始 XML，不现实；更常用的是arrayMode: "always"，对所有同名兄弟节点强制数组化 - 若 XML 中混用单/多个同名标签（如有时
<tag>A</tag>，有时<tag>A</tag><tag>B</tag>），必须开启always，否则结果类型不一致 - 注意
ignoreDeclaration和ignorePi设为true，避免 XML 声明（<?xml ...?>）被误解析为顶层对象
const parser = new XMLParser({
ignoreAttributes: false,
arrayMode: "always",
parseTagValue: false
});
const result = parser.parse(xml); // 所有重复标签都变成 [...]
Java用Jackson XML Module手动控制集合字段
Jackson 的 jackson-dataformat-xml 对单元素数组最稳妥的做法不是靠注解猜，而是用 @JacksonXmlElementWrapper 显式包裹 + @JacksonXmlProperty 标记元素，让序列化器放弃推断。
- 字段声明必须是
List<item></item>类型，不能是Item或Item[]，否则反序列化失败 -
@JacksonXmlElementWrapper(localName = "items")控制外层包装标签名，@JacksonXmlProperty(localName = "item")控制内层元素名，二者缺一不可 - 如果 XML 中
<items></items>可能为空（即无任何<item></item>），需加@JacksonXmlElementWrapper(useWrapping = false)并配合@JsonInclude(JsonInclude.Include.NON_EMPTY)避免空 list 被忽略
单元素转数组这事，核心不在“怎么转”，而在“谁来定义结构”。XML 本身无类型，JSON 数组却是强语义的。一旦后端返回结构随数据量浮动，前端就必须写防御性代码——这比一开始在解析层卡死规则成本高得多。
