You need to enable JavaScript to run this app. Spring Boot引入Xerces实现XSD1.1校验时出现javax.xml多模块冲突错误
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot引入Xerces实现XSD1.1校验时出现javax.xml多模块冲突错误

XSD 1.1 XML校验实现问题解决指南

问题根因

  • 校验时报<assert>元素无效:JDK内置的XML Schema实现默认绑定XSD 1.0规范,完全不识别XSD1.1新增的约束语法
  • 引入Xerces依赖后报多模块访问冲突:原引入的旧版xerces:xercesImpljar包内打包了完整的javax.xml.*核心类,而Java 9+开始的模块化体系中,这些类已经属于JDK内置的java.xml命名模块,类路径下的同名包会触发JPMS规则校验,导致编译失败
  • 旧版Xerces(2.11.0)本身不支持XSD1.1语法,就算不出现冲突也无法正常校验

落地解决步骤

1. 替换适配Java 11的无冲突XSD1.1依赖

删除pom中原有xerces:xercesImpl:2.11.0依赖,替换为经过OSGi模块化适配、无重复核心类的Xerces实现:

<dependency>
    <groupId>org.eclipse.xerces</groupId>
    <artifactId>xercesImpl</artifactId>
    <version>2.12.2</version>
</dependency>

注:该版本已移除jar内重复打包的javax.xml.*核心类,仅保留XSD1.1校验逻辑,不会和JDK内置的java.xml模块产生冲突

2. 修正校验实现代码

  • 删掉代码中重复声明的Validator变量行(原代码重复写了两行Validator validator = schema.newValidator();,属于笔误)
  • 显式指定XSD1.1对应的Schema工厂实现,避免SPI加载时默认走XSD1.0逻辑
    修正后的完整代码:
import javax.xml.XMLConstants;
import javax.xml.transform.stream.StreamSource;
import javax.xml.validation.Schema;
import javax.xml.validation.SchemaFactory;
import javax.xml.validation.Validator;
import java.io.InputStream;

private boolean validateAgainstXSD(InputStream xml, InputStream xsd) {
    try {
        // 直接实例化XSD1.1专用的Schema工厂,避免SPI加载失效
        SchemaFactory factory = new org.apache.xerces.jaxp.validation.XMLSchema11Factory();
        Schema schema = factory.newSchema(new StreamSource(xsd));
        Validator validator = schema.newValidator();
        validator.validate(new StreamSource(xml));
        return true;
    } catch(Exception ex){
        ex.printStackTrace();
        return false;
    }
}

3. 补充编译配置规避残留冲突

如果IDE/编译阶段仍提示包多模块访问,在maven-compiler-plugin中添加参数,显式声明java.xml模块的优先级:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <compilerArgs>
            <arg>--add-modules</arg>
            <arg>java.xml</arg>
        </compilerArgs>
    </configuration>
</plugin>

避坑说明

  • 不要依赖SPI方式加载XSD1.1的SchemaFactory(即不要用SchemaFactory.newInstance("http://www.w3.org/XML/XMLSchema/v1.1")),Spring Boot打为fat jar后很容易因为META-INF/services文件被覆盖,导致类加载失败
  • 不要降级Java版本规避模块冲突,Java 11是项目固定版本,替换适配的依赖是最稳定的方案

内容的提问来源于stack exchange,提问作者Arya F

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 05:06:04