ProviderNotFoundException 表示 ServiceLoader 已定位 SPI 配置文件并解析出实现类名，但加载该类失败，原因包括类不存在、不可见、无公共无参构造器、ClassLoader 隔离或模块系统未正确声明 provides/uses。
ProviderNotFoundException 是什么，为什么不是 ClassNotFoundException
这个异常不是类没加载，而是 ServiceLoader 找到了接口，也扫描了 META-INF/services/xxx 文件，但按文件里写的类名去加载时失败了——可能是类不存在、不可见、构造失败，或者被不同 ClassLoader 隔离了。它和 ClassNotFoundException 的关键区别在于：SPI 机制已启动，只是“查到了名字却拿不到实例”。
常见现象：ProviderNotFoundException: No provider found for interface com.example.MyService，但你确认 jar 包里有 META-INF/services/com.example.MyService，且里面写了 com.example.impl.MyServiceImpl。
- 检查该实现类是否真的在 classpath 下（比如被 Maven
scope=provided排除了） - 确认该类不是
package-private或缺少 public 无参构造器 - 如果用模块系统（Java 9+），确保
module-info.java中导出了实现类所在的包，并在uses或provides中声明了 SPI 关系
services 文件路径和命名必须严格匹配接口全限定名
META-INF/services/ 下的文件名不是随便起的，必须和 ServiceLoader.load(XXX.class) 传入的接口类全限定名**完全一致**，包括大小写、包路径、不能有多余空格或 BOM 字符。
例如加载 java.nio.file.spi.FileTypeDetector，文件名必须是 META-INF/services/java.nio.file.spi.FileTypeDetector，少一个点、多一个空格、用下划线代替点，都会导致 ProviderNotFoundException。
立即学习“Java免费学习笔记（深入）”；
- 用 IDE 查看文件编码，避免 UTF-8 with BOM 导致首行读成乱码
- Linux/macOS 下注意大小写敏感，Windows 上可能“碰巧”通过，但部署到服务器就失败
- 文件内容每行一个实现类名，末尾换行符要规范（推荐 LF），空行会被跳过，但注释不被支持
ServiceLoader 默认只用上下文 ClassLoader，跨模块/容器时容易失效
默认情况下，ServiceLoader.load(Interface.class) 使用的是当前线程的 Thread.currentThread().getContextClassLoader()。在 Web 容器（Tomcat）、OSGi、JLink 自定义镜像或 Spring Boot fat jar 场景下，这个 CL 往往不包含你的 SPI 实现类。
典型表现：本地 main 方法能跑通，放到 Tomcat 就报 ProviderNotFoundException；或者 Spring Boot 启动时报错，但单独打成普通 jar 运行正常。
- 显式指定 ClassLoader：用
ServiceLoader.load(Interface.class, YourClass.class.getClassLoader()) - 在 Servlet 容器中，确保 SPI 文件和实现类都打包在
WEB-INF/classes或某个WEB-INF/lib/*.jar内，而不是放在容器 shared lib 目录 - Spring Boot 用户注意：
spring-boot-loader会包装 ClassLoader，有时需配合spring.factories（那是 Spring 自己的 SPI 变体，和原生ServiceLoader不互通）
Java 9+ 模块系统下，requires 和 provides 必须配对声明
启用模块后，仅把实现类写进 services 文件不够。模块系统会校验：提供方模块是否声明了 provides Interface with Impl，使用方是否 requires 了提供方模块（或至少 requires transitive）。
否则即使类存在、文件正确、ClassLoader 正常，ServiceLoader 仍返回空迭代器，最终触发 ProviderNotFoundException。
- 提供方模块（impl.jar）的
module-info.java必须写：provides com.example.MyService with com.example.impl.MyServiceImpl; - 使用方模块（app.jar）必须写：
requires impl.module.name;（不能只靠 classpath） - 如果使用
jlink构建最小运行镜像，记得把提供方模块加进--add-modules，否则模块图里根本没它
最常被忽略的是类加载隔离和模块声明的耦合——你以为文件放对了就行，其实 JVM 在两个层面（ClassLoader + ModuleLayer）都在做校验。一个环节断了，ProviderNotFoundException 就来了。
