XSD扩展咨询：如何在父级定义common3/4以适配含唯一嵌套元素的XML

首先，你的复用公共元素、通过子XSD扩展差异部分的思路是对的，但当前实现存在几个关键问题，导致无法达到预期的复用效果：

1. 父XSD的message定义错误：你在parent.xsd里直接定义了<xs:element name="message">的复杂类型，而子XSD中extension base="message"需要引用的是复杂类型，不是元素，这会直接导致语法报错。
2. 重复定义common3/common4违背复用原则：两个子XSD都重新定义了这两个元素，完全丢失了父级统一约束它们结构的意义，相当于把公共部分也重复写了一遍。
3. <xs:include>的使用场景不合适：include用于导入同命名空间的XSD片段，这里更适合用<xs:import>（如果子XSD使用独立命名空间）或者调整父XSD结构来支持扩展。

正确实现方案：父级定义公共框架，子级扩展差异类型 #

我们可以把父XSD设计为定义可复用的基础复杂类型和抽象类型，让子XSD继承并填充差异部分，以下是具体实现：

1. 父XSD（parent.xsd）：定义公共结构与抽象类型 #

这里将message定义为可复用的复杂类型，同时把common3和common4的类型设为抽象类型，留给子XSD实现具体内容：

<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <!-- 定义公共的message基础类型 -->
    <xs:complexType name="BaseMessageType">
        <xs:sequence>
            <xs:element name="common1" type="xs:string"/>
            <xs:element name="common2" type="xs:string"/>
            <!-- 用抽象类型定义common3、common4的占位 -->
            <xs:element name="common3" type="BaseCommon3Type"/>
            <xs:element name="common4" type="BaseCommon4Type"/>
        </xs:sequence>
    </xs:complexType>

    <!-- 抽象类型：common3的基础框架 -->
    <xs:complexType name="BaseCommon3Type" abstract="true"/>
    <!-- 抽象类型：common4的基础框架 -->
    <xs:complexType name="BaseCommon4Type" abstract="true"/>
</xs:schema>

2. 子XSD 1（child1.xsd）：实现第一种消息的差异部分 #

通过扩展父级的抽象类型，添加unique1和unique2：

<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <!-- 导入父XSD -->
    <xs:import schemaLocation="parent.xsd"/>

    <!-- 扩展BaseCommon3Type，添加unique1 -->
    <xs:complexType name="Child1Common3Type">
        <xs:complexContent>
            <xs:extension base="BaseCommon3Type">
                <xs:sequence>
                    <xs:element name="unique1" type="xs:string"/>
                </xs:sequence>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>

    <!-- 扩展BaseCommon4Type，添加unique2 -->
    <xs:complexType name="Child1Common4Type">
        <xs:complexContent>
            <xs:extension base="BaseCommon4Type">
                <xs:sequence>
                    <xs:element name="unique2" type="xs:string"/>
                </xs:sequence>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>

    <!-- 定义具体的message元素，绑定扩展后的类型 -->
    <xs:element name="message">
        <xs:complexType>
            <xs:complexContent>
                <xs:restriction base="BaseMessageType">
                    <xs:sequence>
                        <xs:element name="common1" type="xs:string"/>
                        <xs:element name="common2" type="xs:string"/>
                        <xs:element name="common3" type="Child1Common3Type"/>
                        <xs:element name="common4" type="Child1Common4Type"/>
                    </xs:sequence>
                </xs:restriction>
            </xs:complexContent>
        </xs:complexType>
    </xs:element>
</xs:schema>

3. 子XSD 2（child2.xsd）：实现第二种消息的差异部分 #

同理，扩展抽象类型添加unique3和unique4：

<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:import schemaLocation="parent.xsd"/>

    <xs:complexType name="Child2Common3Type">
        <xs:complexContent>
            <xs:extension base="BaseCommon3Type">
                <xs:sequence>
                    <xs:element name="unique3" type="xs:string"/>
                </xs:sequence>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>

    <xs:complexType name="Child2Common4Type">
        <xs:complexContent>
            <xs:extension base="BaseCommon4Type">
                <xs:sequence>
                    <xs:element name="unique4" type="xs:string"/>
                </xs:sequence>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>

    <xs:element name="message">
        <xs:complexType>
            <xs:complexContent>
                <xs:restriction base="BaseMessageType">
                    <xs:sequence>
                        <xs:element name="common1" type="xs:string"/>
                        <xs:element name="common2" type="xs:string"/>
                        <xs:element name="common3" type="Child2Common3Type"/>
                        <xs:element name="common4" type="Child2Common4Type"/>
                    </xs:sequence>
                </xs:restriction>
            </xs:complexContent>
        </xs:complexType>
    </xs:element>
</xs:schema>

另一种灵活方案：使用元素替换组（substitutionGroup） #

如果希望更灵活地替换common3/common4下的子元素，可以用替换组机制，无需扩展整个类型：

父XSD调整： #

<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:complexType name="BaseMessageType">
        <xs:sequence>
            <xs:element name="common1" type="xs:string"/>
            <xs:element name="common2" type="xs:string"/>
            <xs:element name="common3">
                <xs:complexType>
                    <xs:sequence>
                        <!-- 定义抽象元素，允许子元素替换 -->
                        <xs:element name="uniqueBase" type="xs:string" abstract="true"/>
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
            <xs:element name="common4">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="uniqueBase2" type="xs:string" abstract="true"/>
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
        </xs:sequence>
    </xs:complexType>

    <xs:element name="message" type="BaseMessageType"/>
</xs:schema>

子XSD 1： #

<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:import schemaLocation="parent.xsd"/>

    <!-- 定义可替换uniqueBase的元素 -->
    <xs:element name="unique1" type="xs:string" substitutionGroup="uniqueBase"/>
    <!-- 定义可替换uniqueBase2的元素 -->
    <xs:element name="unique2" type="xs:string" substitutionGroup="uniqueBase2"/>
</xs:schema>

这种方式下，你的两种XML消息都能被父XSD验证，因为unique1/unique3会自动替换抽象的uniqueBase，unique2/unique4替换uniqueBase2。

内容的提问来源于stack exchange，提问作者R.C