Java的SPI机制详解

一、前言

面向对象设计鼓励模块间基于接口而非具体实现编程，以降低模块间的耦合，遵循依赖倒置原则，并支持开闭原则（对扩展开放，对修改封闭）。然而，直接依赖具体实现会导致在替换实现时需要修改代码，违背了开闭有原则。为了解决这一问题，SPI 应运而生，它提供了一种服务发现机制，允许在程序外部动态指定具体实现。这与控制反转（IOC）的思想相似，将组件装配的控制权移交给了程序之外。

二、什么是SPI机制？

SPI（Service Provider Interface）是JDK内置的一种服务提供发现机制，可以用来实现接口和实现类的解耦。你可以简单理解为，系统只需要定义接口规范以及可以发现接口实现的机制，而不用去实现接口。

小伙伴们应该都知道java中的java.sql.Driver接口，它就是用到了SPI机制，java中只定义了数据库连接接口的规范，其它不同厂商可以针对这个接口做出不同的实现，MySQL和Oracle都有不同的实现提供给用户，而java的SPI机制可以为某个接口寻找服务实现。

研究过Springboot源码的小伙伴应该也能知道Springboot中也有应用SPI机制机制的，比如Springboot的自动装配中查找spring.factories文件的步骤就是应用了SPI机制。

java中SPI机制的主要思想是将装配的控制权移到程序之外，在模块化设计中这个机制很重要，它的核心思想就是解耦。

下图为SPI机制整体流程图：

当服务的提供者提供了一种接口的实现之后，需要在 classpath 下的 META-INF/services/ 目录里创建一个以服务接口全限定名命名的文件，这个文件里的内容就是这个接口的具体的实现类（可以参考以下MySQL JDBC驱动截图）。当其它程序需要这个服务的时候，就可以通过查找这个 jar 包（一般以 jar 包做依赖）的 META-INF/services/ 中的配置文件，配置文件中有接口的具体实现类名，可以根据这个类名进行加载实例化，就可以使用该服务了。JDK 中查找服务的实现的工具类是：java.util.ServiceLoader，ServiceLoader会遍历所有jar包resources中META-INF/services目录下的文件。

三、代码示例

步骤1，定义一个接口，并写出该接口的实现（可以有多个实现）

java 复制代码

package TestSPI;

/**
 * @date 2025-09-25 16:56
 */
public interface Animal {
    void eat();
}

java 复制代码

package TestSPI;

/**
 * @date 2025-09-25 16:57
 */
public class Dog implements Animal{
    @Override
    public void eat() {
        System.out.println("狗吃骨头");
    }
}

java 复制代码

package TestSPI;

/**
 * @date 2025-09-25 16:57
 */
public class Pig implements  Animal{
    @Override
    public void eat() {
        System.out.println("猪吃饲料");
    }
}

步骤2，在 src/main/resources/ 目录下建立 META-INF/services 目录，新增一个以接口全限定类名来命名的文件，内容是要应用的实现类全限定类名

如图：

文件内容如下：

步骤3，使用 ServiceLoader 来加载配置文件中指定的实现类

测试：

java 复制代码

public class TestSPIDemo {
    public static void main(String[] args) {
        //这段代码使用Java SPI机制加载Animal接口的所有实现类。ServiceLoader.load(Animal.class)会查找并
        //加载在META-INF/services目录下配置的Animal接口实现类，返回一个ServiceLoader对象用于遍历这些实现类实例。
        ServiceLoader<Animal> load = ServiceLoader.load(Animal.class);
        for(Animal animal:load){
            animal.eat();
        }
    }
}

运行结果：

ServiceLoader.load(Search.class)在加载某接口时，会去META-INF/services下找接口的全限定名文件，再根据文件里面的内容加载相应的实现类。

这就是SPI的思想，接口的实现由服务提供方实现，服务提供方只用在提交的jar包里的META-INF/services下根据平台定义好接口新建文件，并添加进相应的实现类内容就好。