ServiceLoader.load() 找不到实现类的根本原因是 META-INF/services/ 下配置文件名非接口全限定名或未置于 classpath 根路径；需确保文件存在、内容为实现类全限定名、模块中声明 uses/provides。
ServiceLoader.load() 为什么找不到实现类
根本原因通常是 META-INF/services/ 下的服务配置文件名写错了，或者没放在 classpath 根路径。它必须是接口的**全限定名**（比如 com.example.MyService），不能是实现类名，也不能带 .class 后缀。
常见错误现象：ServiceLoader 返回空迭代器，iterator().hasNext() 为 false，但编译和包结构看起来都对。
- 检查
META-INF/services/com.example.MyService文件是否存在，且内容只有一行：实现类的全限定名（如com.example.impl.MyServiceImpl） - 确认该文件在最终 jar 或 classes 目录下处于
META-INF/services/路径，不是src/main/resources/META-INF/services/但被构建工具漏掉了 - 如果用模块系统（Java 9+），需在
module-info.java中显式声明uses com.example.MyService;，否则ServiceLoader不会扫描该模块内的实现
load() 和 reload() 的区别与使用时机
ServiceLoader.load() 每次调用都新建一个实例，重新扫描 classpath；reload() 是对已有实例重置内部迭代器，不重新加载类，也不感知新加入的 jar —— 它只是让已加载的那些实现能再次遍历。
典型使用场景是热插拔不敏感的静态扩展点，比如启动时加载一次日志格式处理器，后续不会动态增删。
立即学习“Java免费学习笔记（深入）”；
- 绝大多数情况只用
ServiceLoader.load(MyService.class)，无需缓存或反复reload() -
reload()仅在你确定 classloader 已加载新实现、且想复用原ServiceLoader实例时才用（极少） - 不要在循环里反复
load()，会重复触发类加载和static块执行，可能引发意外副作用
接口方法抛异常时，ServiceLoader 会静默吞掉吗
不会吞，但行为取决于你怎么遍历。如果你用 for (MyService s : loader) { s.doSomething(); }，某个实现的 doSomething() 抛出未捕获异常，整个遍历就中断了，后面的实现根本不会执行。
这和“SPI 失败不影响其他实现”的预期相悖，也是最容易被忽略的坑。
- 务必手动 try-catch 每个服务实例的调用，例如：
for (MyService service : ServiceLoader.load(MyService.class)) { try { service.handle(data); } catch (Exception e) { // 记 log，别 throw 出去 logger.warn("Service {} failed", service.getClass().getName(), e); } } - 不要依赖
iterator().next()自动抛异常来控制流程，SPI 场景下“尽力而为”比“强一致性”更合理 - 如果某实现的
static块失败，它会被ServiceLoader彻底跳过（连实例都不创建），且无任何提示 —— 所以避免在static块里做重逻辑
Java 9+ 模块化下 ServiceLoader 的兼容写法
模块系统默认不导出 META-INF/services 资源，也不自动识别 uses，所以老代码迁移到模块后常直接失效。
核心是两件事：资源可见性 + 模块声明。
- 在提供方模块（即含实现类的模块）的
module-info.java中加：provides com.example.MyService with com.example.impl.MyServiceImpl;
- 在使用方模块中加：
uses com.example.MyService;
- 确保
META-INF/services/文件仍保留在 jar 包内（Gradle/Maven 默认保留，但某些 shade 插件会删，需检查） - 如果用
--patch-module或非模块 classpath 加载，仍可走传统路径，但混合模式容易混乱，建议统一
模块化后，ServiceLoader 优先走模块声明，fallback 到传统机制；但一旦用了 provides，就必须配 uses，否则编译期就报错。
