使用Java验证含include的XSD关联XML时遇元素声明缺失错误

问题场景 #

我需要用数据库中存储的XSD Schema验证XML，这些Schema通过import和include关联。把所有关联的Schema传入验证函数后，仅用import时验证正常，但用include会抛出错误：

org.xml.sax.SAXParseException; cvc-elt.1.a: Cannot find the declaration of element

当前代码如下：

// p_schemasArr[] - XSD数组，包含所有通过include和import关联的Schema，已排序，最后一个包含所有前置Schema
// e - XSD总数，最多可达130个
SchemaFactory schemaFactory = SchemaFactory.newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI);
Source[] sources = new Source[e];
for (int i = 0; i < e; i++) {
  sources[i] = new StreamSource(new StringReader(p_schemasArr[i]), "xsd_" + i);
}
Schema schema = schemaFactory.newSchema(sources);
Validator validator = schema.newValidator();
validator.validate(new StreamSource(new StringReader(xmlFileSource.getValue())));

解决办法 #

1. 检查include的命名空间匹配 #

include要求被引入的Schema和主Schema命名空间完全一致，如果被include的Schema有独立命名空间，或者主Schema没指定命名空间，就会找不到元素。

• 核对所有被include的XSD，确保它们的targetNamespace和主Schema完全相同；如果是无命名空间的场景，所有相关Schema都不能指定targetNamespace。

2. 修正Schema的系统标识符 #

代码里给StreamSource设置的标识符是xsd_+i，但XSD中include标签的schemaLocation通常是文件名或路径，解析器会根据这个值查找对应的Schema，两者不匹配就会找不到。

• 修改StreamSource的第二个参数，使其和对应XSD中include的schemaLocation值一致。比如某XSD里写了<xs:include schemaLocation="common.xsd"/>，那对应的StreamSource要把标识符设为"common.xsd"，而非自定义的"xsd_0"。

3. 自定义资源解析器 #

默认解析器习惯从文件系统/URL加载Schema，用内存中的StringReader时可能无法处理include的引用。可以自定义LSResourceResolver，让解析器直接从你的数组中找对应Schema：

schemaFactory.setResourceResolver(new LSResourceResolver() {
    @Override
    public LSInput resolveResource(String type, String namespaceURI, String publicId, String systemId, String baseURI) {
        // 根据systemId匹配数组中的对应XSD，这里需要你维护systemId和数组元素的映射关系
        for (int i = 0; i < p_schemasArr.length; i++) {
            if (systemId.equals(getSchemaFileName(i))) { // getSchemaFileName需自行实现，返回对应XSD的schemaLocation值
                LSInput input = new DOMImplementationLSImpl().createLSInput();
                input.setCharacterStream(new StringReader(p_schemasArr[i]));
                input.setSystemId(systemId);
                return input;
            }
        }
        return null;
    }
});

• 这个解析器会在遇到include/import时，根据systemId从你的数组中加载对应的Schema内容，无需依赖外部文件。

4. 排查重复定义问题 #

如果多个include的Schema中有重复的全局元素定义，会导致解析器无法正确识别主元素。检查所有Schema，移除重复的全局定义；如果需要覆盖原有定义，改用redefine标签。

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