Spring Jar包中ClassPathResource读取XSD文件及依赖引用问题

问题根源 #

ClassPathResource.getFile()只能访问文件系统中的物理文件，当你的Spring应用被打包成Jar后，XSD资源是Jar包内的条目，并非独立文件，因此调用getFile()会直接报错。而你尝试用InputStream读取时的路径问题和内部引用错误，本质是资源路径配置错误+XML解析器无法定位依赖XSD导致的。

步骤1：正确读取Jar内的XSD资源 #

• 资源路径不要带resources前缀：src/main/resources下的文件直接对应classpath根路径，比如你的XSD放在src/main/resources/xsd/facturx-main.xsd，那么读取路径应为xsd/facturx-main.xsd。
• 使用ClassPathResource.getInputStream()获取资源流，代码示例：

ClassPathResource xsdResource = new ClassPathResource("xsd/facturx-main.xsd");
InputStream xsdInputStream = xsdResource.getInputStream();

步骤2：解决XSD内部类型引用问题 #

XSD中类似ram:ExchangedDocumentContextType的引用，通常依赖同目录下的其他XSD文件（比如ram.xsd）。直接用InputStream读取主XSD时，解析器无法自动找到依赖的XSD，需要自定义资源解析器：

方案A：使用Spring的ResourcePatternResolver批量加载XSD #

// 注入Spring的资源解析器
@Autowired
private ResourcePatternResolver resourcePatternResolver;

public Schema loadFacturXSchema() throws Exception {
    // 加载xsd目录下的所有相关XSD文件
    Resource[] xsdResources = resourcePatternResolver.getResources("classpath:xsd/*.xsd");
    Source[] schemaSources = new Source[xsdResources.length];
    
    for (int i = 0; i < xsdResources.length; i++) {
        schemaSources[i] = new StreamSource(xsdResources[i].getInputStream());
    }
    
    SchemaFactory schemaFactory = SchemaFactory.newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI);
    return schemaFactory.newSchema(schemaSources);
}

方案B：自定义LSResourceResolver（纯JDK XML解析场景） #

如果不依赖Spring的资源解析器，可以自定义解析器从classpath加载依赖XSD：

SchemaFactory schemaFactory = SchemaFactory.newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI);
schemaFactory.setResourceResolver(new LSResourceResolver() {
    @Override
    public LSInput resolveResource(String type, String namespaceURI, String publicId, String systemId, String baseURI) {
        // systemId是XSD内引用的相对路径，比如"ram.xsd"
        ClassPathResource resource = new ClassPathResource("xsd/" + systemId);
        LSInputImpl input = new LSInputImpl();
        try {
            input.setByteStream(resource.getInputStream());
            input.setSystemId(systemId);
            return input;
        } catch (IOException e) {
            throw new RuntimeException("Failed to load dependent XSD: " + systemId, e);
        }
    }
});

// 加载主XSD
ClassPathResource mainXsd = new ClassPathResource("xsd/facturx-main.xsd");
Schema schema = schemaFactory.newSchema(new StreamSource(mainXsd.getInputStream()));

步骤3：确保Spring Boot打包后兼容 #

Spring Boot的Fat Jar结构不会影响classpath资源的读取，只要你始终使用InputStream而非File访问资源，并且按上述方式处理XSD依赖，打包成Jar后依然可以正常运行。

额外注意事项 #

• 确保所有依赖的XSD文件都被正确打包进Jar：maven默认会打包src/main/resources下的所有文件，无需额外配置。
• 单元测试中同样使用InputStream读取资源，避免本地测试和Jar运行环境不一致。

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