视频看了几百小时还迷糊？关注我，几分钟让你秒懂！
一、为什么企业级项目离不开 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@Component+ 接口注入（更简单） |
| 第三方插件扩展（如 Starter） | 用spring.factories |
| 跨 JAR 包、运行时动态加载 | 用原生 SPI |
| 需要控制加载顺序 | SPI +@Order或自定义排序 |
💡 一般建议：优先用 Spring 机制，除非需要真正的“插件化”能力
七、总结：SPI 的核心价值
| 价值 | 说明 |
|---|---|
| 解耦 | 核心模块不依赖具体实现 |
| 扩展性 | 新功能以插件形式加入 |
| 灵活性 | 运行时动态选择实现 |
| 标准化 | 接口即契约，降低协作成本 |
掌握 SPI，你就能设计出像JDBC、Dubbo、Spring Boot一样优雅的可扩展系统！
视频看了几百小时还迷糊？关注我，几分钟让你秒懂！
