在 XSD 中,元素出现任意次数需用 minOccurs=”0″ maxOccurs=”unbounded”;属性不支持 unbounded;unbounded 须置于 sequence 等容器内,不可用于 all 或 complexType 标签上。

如何在 XSD 中让元素出现任意次数(unbounded)
在 XSD 中,maxOccurs="unbounded" 是唯一标准方式,用于声明某个元素可重复零次、一次或无限次。它必须配合 minOccurs 使用,否则默认为 1,即至少出现一次。
常见错误是只写 maxOccurs="unbounded" 却忽略 minOccurs,结果导致 XML 校验时要求该元素必须存在且可重复——这和“可选 + 任意次”的预期不符。
-
minOccurs="0" maxOccurs="unbounded":完全可选,出现 0 次、1 次、多次都合法 -
minOccurs="1" maxOccurs="unbounded":必须至少出现 1 次,最多不限 -
minOccurs和maxOccurs只能用于,不能直接用于
XSD 中属性(attribute)无法设置 unbounded
属性天生就是单值的,XSD 规范不允许对 使用 maxOccurs 或 minOccurs。如果你看到类似报错:Invalid attribute 'maxOccurs' for element 'attribute',说明你试图给属性加重复性控制——这是语法错误,根本不可行。
需要“多个同名属性”语义?实际应转换为子元素。例如,不要设计成:(XML 本身不允许多个同名属性),而应改为:
A B
然后用 minOccurs="0" maxOccurs="unbounded" 约束 元素。
unbounded 在复杂类型(complexType)中的位置很关键
当你在 内定义可重复元素时,maxOccurs="unbounded" 必须放在该元素声明的 ** 直接父容器 ** 上——这个容器通常是 、 或 。但注意: 不允许 maxOccurs="unbounded",会报错 cos-all-limited.1.2。
典型安全写法是包裹在 中:
如果误把 maxOccurs 放在 标签上,或者套在 里,XSD 解析器会拒绝加载。
unbounded 的实际校验行为与性能提示
虽然 maxOccurs="unbounded" 逻辑上表示“无限”,但实际解析器(如 Xerces、libxml2、.NET XmlSchemaSet)都会设内部上限(例如 10000 次),防止恶意构造超长列表导致内存耗尽。这不是 XSD 标准规定,而是实现保护。
如果你的业务真需要容纳数千个同名元素,要注意两点:
- 确保所用 XML处理器 支持足够大的重复数(查文档确认其
maxOccurs实际限制) - 避免在
中混用多个unbounded元素(如 A 和 B 都unbounded),会导致校验歧义,部分老解析器可能报cos-nonambig错误
真正容易被忽略的是:unbounded 只控制“出现次数”,不控制内容是否重复——它不管值是否相同,也不触发去重或排序逻辑。那是应用层的事。