SPI要求严格遵循META-INF/services/接口全限定名路径、命名及每行一个无参构造实现类的格式，否则ServiceLoader会静默失败或抛ServiceConfigurationError；实现类需通过TCCL加载，且接口应优先用default方法扩展以保障兼容性。
能，但必须严格遵循 META-INF/services 文件路径、命名、内容三要素，否则 ServiceLoader 会静默失败或抛 ServiceConfigurationError。
配置文件必须放在 META-INF/services/ 且以接口全限定名命名
这是 SPI 能工作的硬性前提。不是 resources/META-INF/...，也不是 src/main/resources/META-INF/... —— 构建后它必须出现在最终 jar 包根路径下的 META-INF/services/ 目录里。
- 假设日志接口是
com.example.log.LogService，那配置文件路径必须是META-INF/services/com.example.log.LogService - 文件内容每行一个实现类全限定名，例如：
com.example.log.ConsoleLogService，末尾不能有多余空格或 BOM 头 - 如果用了 Maven，确认
src/main/resources下的META-INF被正确打包；Gradle 用户要检查resources.srcDirs是否包含该路径 - 常见错误：IDE 自动在
resources下建了META-INF，但 Maven 没把它复制进 jar —— 用jar -tf your-app.jar | grep services验证
ServiceLoader 加载时对构造函数和类加载器敏感
ServiceLoader.load() 不是简单反射 new 实例，它依赖线程上下文类加载器（TCCL）去加载实现类。一旦类加载器链断裂，就会抛 ServiceConfigurationError 或 NoClassDefFoundError。
- 所有 SPI 实现类必须有 public 无参构造函数；带参或私有构造会直接触发
ServiceConfigurationError - 若日志实现依赖第三方库（如
log4j-core），确保该依赖在运行时 classpath 中，而不仅是编译期 - 在 Web 容器（如 Tomcat）或 Spring Boot Fat Jar 场景下，TCCL 可能不是应用类加载器 —— 建议显式传入：
ServiceLoader.load(LogService.class, Thread.currentThread().getContextClassLoader()) - 不要在循环中反复调用
load()；应缓存ServiceLoader实例或使用单例包装，避免重复扫描开销
多实现共存时，findFirst() 和遍历顺序不等于 classpath 顺序
ServiceLoader 返回的迭代器顺序由 JVM 扫描 jar 包的顺序决定，而该顺序受 classpath 中 jar 排列、文件系统 readdir 行为影响，并非 Maven 依赖声明顺序。
- 不要依赖
loader.iterator().next()获取“默认”实现；更稳妥的是定义策略，比如读取配置项logging.impl=console，再匹配实现类名 - 若需 fallback 逻辑（如找不到指定实现就用默认），应在代码中主动判断，而不是靠加载顺序
- 多个实现同时生效？可以遍历全部并聚合（如同时输出到控制台和文件），但要注意线程安全和性能 —— 日志方法本身应尽量轻量，避免在
log()内做 I/O 切换 - Spring Boot 用户注意：
@ConditionalOnClass或@ConditionalOnProperty控制自动配置 Bean 的开关，和 SPI 是两套机制，别混用导致行为冲突
日志接口设计要预留扩展空间，避免因新增方法导致旧实现编译失败
SPI 的核心价值是解耦，但接口一旦发布，修改成本极高。增加方法会导致所有已部署的插件实现类编译不过或运行时报 AbstractMethodError。
- 优先用
default方法添加新能力（JDK 8+），例如：default void trace(String msg) { log(Level.TRACE, msg); } - 避免在接口中暴露具体实现细节（如
FileOutputStream、Connection），只暴露语义契约（log(Level, String)） - 考虑加入
isEnabled(Level)避免无效字符串拼接，这对 DEBUG 级别尤其关键 - 如果未来要支持异步日志，不要在接口加
asyncLog()，而是通过包装器或独立 SPI 接口（如AsyncLogProvider）演进
真正难的不是写几个实现类，而是让第一个插件在别人的工程里不报错地跑起来 —— 这取决于你对类加载边界、META-INF 文件落地位置、以及接口契约稳定性的把控。任何一步出偏差，ServiceLoader 都不会告诉你哪错了，只会返回空迭代器或抛异常。
