SPI 在实际项目中的应用：从日志框架到微服务插件化（附 Spring Boot 实战）

视频看了几百小时还迷糊？关注我，几分钟让你秒懂！

一、为什么企业级项目离不开 SPI？

在真实开发中，我们常遇到这些需求：

• 日志系统要支持切换 Logback / Log4j2，但代码不能改
• 支付模块要支持微信、支付宝、银联，未来还要加数字货币
• 数据导出要支持 Excel、CSV、PDF，且可动态扩展
• 监控组件要兼容 Prometheus、SkyWalking、Zipkin

👉 这些场景的共同点：核心逻辑固定，具体实现可变。

而SPI（Service Provider Interface）正是解决这类“开闭原则”问题的利器！

二、实战案例1：统一支付网关（插件化设计）

🎯 需求

• 系统支持多种支付方式
• 新增支付渠道无需修改主流程
• 通过配置动态选择支付实现

✅ 步骤1：定义支付接口（核心规范）

// PaymentService.java public interface PaymentService { String payType(); // 返回支付类型，如 "wechat", "alipay" boolean pay(PaymentRequest request); }

✅ 步骤2：实现微信支付

// WechatPaymentServiceImpl.java public class WechatPaymentServiceImpl implements PaymentService { @Override public String payType() { return "wechat"; } @Override public boolean pay(PaymentRequest request) { System.out.println("调用微信支付 API，金额：" + request.getAmount()); return true; // 模拟成功 } }

✅ 步骤3：注册 SPI（关键！）

创建文件：
src/main/resources/META-INF/services/com.example.payment.PaymentService

内容：

com.example.payment.impl.WechatPaymentServiceImpl com.example.payment.impl.AlipayPaymentServiceImpl

✅ 步骤4：支付上下文（自动加载所有实现）

// PaymentContext.java @Component public class PaymentContext { private final Map<String, PaymentService> paymentMap = new ConcurrentHashMap<>(); @PostConstruct public void init() { ServiceLoader<PaymentService> loader = ServiceLoader.load(PaymentService.class); for (PaymentService service : loader) { paymentMap.put(service.payType(), service); } System.out.println("已加载支付渠道: " + paymentMap.keySet()); } public boolean executePay(String payType, PaymentRequest request) { PaymentService service = paymentMap.get(payType); if (service == null) { throw new IllegalArgumentException("不支持的支付方式: " + payType); } return service.pay(request); } }

✅ 步骤5：Controller 调用

@RestController public class PayController { @Autowired private PaymentContext paymentContext; @PostMapping("/pay") public String pay(@RequestParam String type, @RequestParam BigDecimal amount) { PaymentRequest request = new PaymentRequest(amount); boolean success = paymentContext.executePay(type, request); return success ? "支付成功" : "支付失败"; } }

✅ 测试：

curl "http://localhost:8080/pay?type=wechat&amount=99.9" # 输出：调用微信支付 API，金额：99.9

💡优势：新增“数字货币支付”？只需写一个实现类 + 注册一行，主流程零修改！

三、实战案例2：日志适配器（解耦日志实现）

很多公司要求统一日志格式，但底层可能用 Logback 或 Log4j2。

✅ 自定义日志门面（避免直接依赖 SLF4J）

// MyLogger.java public interface MyLogger { void info(String msg); void error(String msg, Throwable t); }

✅ 提供 Logback 适配器

// LogbackLoggerImpl.java public class LogbackLoggerImpl implements MyLogger { private final org.slf4j.Logger logger = LoggerFactory.getLogger("MyApp"); @Override public void info(String msg) { logger.info("[MYLOG] {}", msg); } @Override public void error(String msg, Throwable t) { logger.error("[MYLOG] " + msg, t); } }

✅ 注册 SPI

META-INF/services/com.example.log.MyLogger:

com.example.log.impl.LogbackLoggerImpl

✅ 工具类自动加载

// LogManager.java public class LogManager { private static final MyLogger logger; static { ServiceLoader<MyLogger> loader = ServiceLoader.load(MyLogger.class); MyLogger instance = loader.findFirst().orElseThrow( () -> new IllegalStateException("未找到日志实现！") ); logger = instance; } public static MyLogger getLogger() { return logger; } }

使用：

LogManager.getLogger().info("系统启动完成");

✅ 切换日志框架？只需替换依赖 + 提供新实现，业务代码完全不动！

四、Spring Boot 中的高级 SPI：spring.factories实战

原生 SPI 功能有限，Spring Boot 的spring.factories更强大！

🎯 场景：自定义健康检查（HealthIndicator）

你想在/actuator/health中加入自定义指标，比如“数据库连接池状态”。

步骤1：实现 HealthIndicator

// CustomDbHealthIndicator.java @Component public class CustomDbHealthIndicator implements HealthIndicator { @Override public Health health() { // 模拟检查 boolean isOk = checkConnectionPool(); if (isOk) { return Health.up().withDetail("pool", "active=5, idle=10").build(); } else { return Health.down().withDetail("error", "连接池耗尽").build(); } } private boolean checkConnectionPool() { return true; // 实际可查 HikariCP 状态 } }

步骤2：注册到 spring.factories（让 Starter 自动发现）

如果你把这个类打包成my-monitor-spring-boot-starter，则需：

META-INF/spring.factories:

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ com.example.monitor.CustomDbAutoConfiguration

其中CustomDbAutoConfiguration是一个配置类，会注入CustomDbHealthIndicator。

✅ 用户只需引入你的 starter，健康检查自动生效！

五、反例警告 ❌ —— 项目中 SPI 使用陷阱

❌ 反例1：SPI 实现类放在了错误的模块

• 主项目 A 依赖工具包 B
• B 定义了 SPI 接口
• C 实现了该接口
• 但 A 没有依赖 C

💥 结果：ServiceLoader找不到 C 的实现！
✅ 解决：确保实现类所在的 JAR 被主项目依赖

❌ 反例2：多模块项目中 resources 未正确打包

Maven 多模块项目中，如果META-INF/services/...文件放在了 test 目录或未被 resource 插件包含，打包后 JAR 里就没有注册文件！

✅ 检查方法：解压 JAR，确认路径存在：

jar -tf your-app.jar | grep "META-INF/services"

❌ 反例3：并发加载未考虑线程安全

// 错误：非线程安全的 map private Map<String, Service> cache = new HashMap<>();

✅ 正确：使用ConcurrentHashMap或加锁初始化

六、SPI vs Spring Bean？如何选择？

💡 一般建议：优先用 Spring 机制，除非需要真正的“插件化”能力

七、总结：SPI 的核心价值

掌握 SPI，你就能设计出像JDBC、Dubbo、Spring Boot一样优雅的可扩展系统！

视频看了几百小时还迷糊？关注我，几分钟让你秒懂！