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
相关产品推荐
相关产品推荐

