XML Schema中xs:element的fixed属性如何设置XSD元素固定值

XML Schema里的xs:element元素提供了fixed属性，用于为对应的XML实例元素指定一个不可修改的固定值，当XML实例中该元素的值与fixed指定的值不一致时，校验会直接失败。这个属性在需要约束某些元素必须保持统一取值的场景下非常实用，比如接口协议中必须固定的版本标识、业务场景中不变的常量字段等。

xs:element fixed属性的基本规则

fixed属性的取值是一个字符串，它和xs:element的type属性配合使用，要求XML实例中对应元素的值必须与fixed指定的值完全一致，且类型符合type的定义。需要注意fixed和default属性不能同时使用，二者的区别如下：

• fixed：实例元素必须出现该值，否则校验失败，且值不可修改
• default：实例元素可以省略，省略时自动填充默认值，出现时可以修改为其他符合类型的值

fixed属性使用示例

1. 定义带fixed属性的XSD文件

下面的XSD定义了一个用户信息结构，其中data_source元素被固定为system_a，类型为字符串，所有实例的该元素必须等于这个值：

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
           targetNamespace="http://www.ipipp.com/user"
           xmlns:tns="http://www.ipipp.com/user"
           elementFormDefault="qualified">

    <xs:element name="user_info" type="tns:user_info_type"/>

    <xs:complexType name="user_info_type">
        <xs:sequence>
            <xs:element name="user_id" type="xs:string"/>
            <!-- 固定data_source的值为system_a -->
            <xs:element name="data_source" type="xs:string" fixed="system_a"/>
            <xs:element name="user_name" type="xs:string"/>
        </xs:sequence>
    </xs:complexType>

</xs:schema>

2. 符合固定值要求的XML实例

下面的XML实例中data_source的值和fixed定义的一致，校验会通过：

<?xml version="1.0" encoding="UTF-8"?>
<tns:user_info xmlns:tns="http://www.ipipp.com/user"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://www.ipipp.com/user user.xsd">
    <tns:user_id>1001</tns:user_id>
    <tns:data_source>system_a</tns:data_source>
    <tns:user_name>张三</tns:user_name>
</tns:user_info>

3. 不符合固定值要求的XML实例

如果实例中data_source的值被修改，或者元素缺失，都会导致校验失败：

<?xml version="1.0" encoding="UTF-8"?>
<tns:user_info xmlns:tns="http://www.ipipp.com/user"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://www.ipipp.com/user user.xsd">
    <tns:user_id>1001</tns:user_id>
    <!-- 值被修改为system_b，不符合fixed要求 -->
    <tns:data_source>system_b</tns:data_source>
    <tns:user_name>张三</tns:user_name>
</tns:user_info>

fixed属性的其他注意事项

如果xs:element同时设置了fixed和nillable="true"，那么实例元素可以出现xsi:nil="true"的空值情况，此时不需要满足fixed的值要求，这是fixed属性的一个特殊例外场景。另外fixed的值必须和type属性兼容，比如如果type是xs:integer，fixed的值必须是合法的整数，否则XSD本身定义就会出错。

XML_Schemafixed属性xs:elementXSD元素固定值修改时间：2026-06-14 16:57:33