XSD导入外部命名空间引用其类型时出现cvc-complex-type.2.4.a错误

错误原因 #

• 跨命名空间元素归属不匹配：test.xsd配置了elementFormDefault="qualified"，其内部定义的Test类型下的test-import元素属于test命名空间，但测试XML中默认命名空间为test2，未加前缀的<test-import>被识别为归属test2命名空间，与schema要求不符，这是触发cvc-complex-type.2.4.a错误的直接原因，报错提示中的{test}就是指期望的元素所属命名空间。
• 测试XML根元素不匹配：test2.xsd中定义的顶层元素为project，但测试XML根元素使用了未在schema中声明的file。
• xsi:schemaLocation格式错误：标准格式为命名空间URI schema文件路径，当前仅填写了文件路径，缺失命名空间映射声明。

修复方案 #

方案一：调整XML文件的命名空间声明（推荐，符合qualified的设计预期） #

修改后的test.xml代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="test2" 
         xmlns:test="test"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
         xsi:schemaLocation="test2 ./test2.xsd">

    <test>
        <test:test-import>Text</test:test-import>
    </test>
    
    <test2>
        <model-test>Text</model-test>
    </test2>

</project>

改动说明：

1. 根元素从file改为schema中定义的project
2. 新增xmlns:test="test"声明test命名空间的前缀
3. 将<test-import>改为带前缀的<test:test-import>，明确归属test命名空间
4. 修正xsi:schemaLocation为test2 ./test2.xsd，符合标准格式要求

方案二：调整test.xsd的元素命名空间要求 #

如果希望<test-import>保留无前缀的写法，可以修改test.xsd的elementFormDefault为unqualified，修改后的代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema 
  targetNamespace="test"
  xmlns="test"
  xmlns:xs="http://www.w3.org/2001/XMLSchema" 
  elementFormDefault="unqualified" >

    <xs:complexType name="Test">
        <xs:all>
            <xs:element name="test-import" minOccurs="0" type="xs:string" />
        </xs:all>
    </xs:complexType>

</xs:schema>

该配置下，test.xsd定义的局部元素不需要带对应命名空间前缀，仅需同步修正XML的根元素和xsi:schemaLocation配置即可通过校验。

内容的提问来源于stack exchange，提问作者rockseisen