如何禁用特定Java库的服务（SPI）注册？

针对你遇到的需要阻止特定xercesImpl版本注册为SAXParser服务提供者的问题，除了手动删除JAR包中的META-INF/services目录，还有以下几种侵入性更低的方法：

1. 构建阶段自动过滤SPI文件（推荐） #

利用构建工具插件，在打包过程中自动移除目标JAR里的SPI注册文件，无需手动修改JAR：

• Maven：使用maven-shade-plugin配置资源过滤，排除xercesImpl对应的SAXParser服务注册文件：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.4.1</version>
    <executions>
      <execution>
        <phase>package</phase>
        <goals>
          <goal>shade</goal>
        </goals>
        <configuration>
          <filters>
            <filter>
              <artifact>xerces:xercesImpl</artifact>
              <excludes>
                <exclude>META-INF/services/javax.xml.parsers.SAXParserFactory</exclude>
              </excludes>
            </filter>
          </filters>
        </configuration>
      </execution>
    </executions>
  </plugin>
  

• Gradle：通过shadowJar插件过滤目标SPI文件：

  shadowJar {
    exclude 'META-INF/services/javax.xml.parsers.SAXParserFactory'
    from configurations.runtimeClasspath
  }
  

2. 依赖替换为无SPI版本 #

如果xercesImpl有不含SPI注册的变体版本（类似你提到的allure分发包形式），可通过依赖管理强制覆盖依赖树中的版本：

<!-- Maven dependencyManagement 示例 -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>xerces</groupId>
      <artifactId>xercesImpl</artifactId>
      <version>[无SPI版本号]</version>
    </dependency>
  </dependencies>
</dependencyManagement>

3. 自定义ClassLoader过滤服务加载 #

实现自定义ClassLoader，在读取SPI注册文件时跳过xercesImpl的注册项，适合无法修改构建流程的场景：

public class FilteringClassLoader extends ClassLoader {
    public FilteringClassLoader(ClassLoader parent) {
        super(parent);
    }

    @Override
    public InputStream getResourceAsStream(String name) {
        if ("META-INF/services/javax.xml.parsers.SAXParserFactory".equals(name)) {
            InputStream original = super.getResourceAsStream(name);
            if (original == null) return null;
            // 过滤掉xercesImpl的注册行
            String filtered = new BufferedReader(new InputStreamReader(original))
                    .lines()
                    .filter(line -> !line.startsWith("org.apache.xerces.jaxp.SAXParserFactoryImpl"))
                    .collect(Collectors.joining("\n"));
            return new ByteArrayInputStream(filtered.getBytes(StandardCharsets.UTF_8));
        }
        return super.getResourceAsStream(name);
    }
}

启动应用时使用该ClassLoader加载相关类即可。

4. JVM参数强制指定SAXParser实现 #

通过系统属性全局指定要使用的SAXParserFactory实现，直接覆盖SPI加载结果：

# 启动应用时添加JVM参数
-Djavax.xml.parsers.SAXParserFactory=[你期望的实现类全限定名]

这种方法简单直接，但会全局替换SAXParser实现，需确保其他XML模块兼容指定的实现类。

内容的提问来源于stack exchange，提问作者Reto Höhener