xs:attribute fixed 强制属性必须出现且值严格匹配指定字面量,不可省略或偏差;与 default 互斥;用于版本、协议常量等不可变元信息;代码生成仅提供只读保护,不替代 xml 层校验。

xs:attribute fixed 在 XSD 中到底起什么作用
它不是“默认值”,也不是“只读约束”,而是强制要求该属性在 XML 实例中**必须出现且值必须完全匹配** fixed 指定的字面量。如果 XML 里没写这个属性,或者写了但值不一致,解析器就会报错。
常见错误现象:cvc-complex-type.3.2.2(属性缺失)或 cvc-complex-type.3.2.1(属性值不匹配),尤其在用 xsd.exe、xmlschema 或 Java 的 jaxb 生成类时,容易误以为是可选字段。
-
fixed和default不能共存于同一个xs:attribute - 如果 XML 实例中显式写了该属性,值必须和
fixed="xxx"完全一致(包括大小写、空格、转义) - 即使类型是
xs:boolean,也必须写字符串"true"或"false",不能写1/0
怎么写才不会被校验器拒绝
关键在 XML 实例中——你不能省略它,也不能“灵活处理”。比如 XSD 定义了:
<xs:attribute name="version" type="xs:string" fixed="2.1"/>
那么合法的 XML 只能是:
<root version="2.1">...</root>
以下全部非法:
-
<root>...</root>(缺少version属性) -
<root version="2.10"></root>(值不精确匹配) -
<root version=" 2.1 "></root>(首尾空格也算差异) -
<root version="2.1" xmlns:xsi="..." xsi:type="..."></root>(其他属性不影响,但version本身仍需严格)
fixed 和 default 混用时的典型陷阱
很多人想“有就用给定值,没有就补上”,于是试图同时设 fixed 和 default,XSD 解析器会直接报错:src-attribute.3。XSD 规范明确禁止这种组合。
真实使用场景其实很窄:多用于版本标识、协议常量、强制命名空间前缀等“绝不允许变动”的元信息。
- 需要“存在即固定” → 用
fixed - 需要“不存在时补默认,存在时可覆盖” → 用
default - 需要“必须存在,但值可变” → 去掉
fixed和default,靠业务逻辑校验
Java / .NET 生成代码时 fixed 属性的表现
工具通常把 fixed 属性生成为只读字段或构造后不可改的属性,但注意:这仅是代码层面的“友好提示”,**不替代 XML 校验**。如果你手动构造 XML 字符串并漏掉或写错该属性,运行时仍会触发 Schema 校验失败。
例如 JAXB 的 @XmlAttribute 注解不会自动注入 fixed 值;xsd.exe 生成的 C# 类中对应属性也没有 setter —— 但这只是防止你改,不是帮你填。
- 不要依赖生成代码“自动补值”,XML 文本本身必须合规
- 测试时务必用真实 XML 文件 + Schema 校验器(如
xmllint --schema)验证,别只跑单元测试 - 如果要用程序生成含
fixed属性的 XML,建议硬编码拼接,或用 DOM/SAX 显式设置,避免模板引擎意外删空格
fixed 的严格性藏在 Schema 层,不在代码层。最容易被忽略的是:它对空白字符、命名空间前缀、XML 声明顺序都敏感,而这些在编辑器里往往看不见。










