ServiceLoader机制解析与使用教程

学习知识要善于思考，思考，再思考！今天golang学习网小编就给大家带来《ServiceLoader加载机制详解》，以下内容主要包含等知识点，如果你正在学习或准备学习文章，就都不要错过本文啦~让我们一起来看看吧，能帮助到你就更好了！

ServiceLoader 通过读取 META-INF/services/ 下以接口全限定名命名的文本文件来加载实现类，文件每行一个实现类全限定名，需严格匹配包名和大小写；load() 仅解析配置，next() 才触发 Class.forName 和实例化，使用线程上下文类加载器，默认非单例。

ServiceLoader 不是“自动扫描类路径”，它只读 META-INF/services/ 下的配置文件，然后按需加载实现类——没配就找不到，配错名就 ClassNotFound。

ServiceLoader 从哪读实现类列表

它只看 META-INF/services/ 目录下以接口全限定名命名的文本文件（比如 java.sql.Driver 接口对应文件路径是 META-INF/services/java.sql.Driver）。该文件每行写一个实现类的全限定名，例如：

com.mysql.cj.jdbc.Driver
org.postgresql.Driver

注意：文件名必须和 ServiceLoader.load(Xxx.class) 中传入的接口类型完全一致（包括包名），大小写敏感；文件内容不能有空格、注释或空行，否则解析失败或跳过。

load() 后不立即实例化，next() 才触发 Class.forName + newInstance

ServiceLoader 是懒加载的。调用 ServiceLoader.load(Interface.class) 只解析配置文件、缓存类名，不加载任何类。真正触发类加载和实例化的是迭代时调用 iterator().next() 或 forEach()：

• 第一次 next() 会执行 Class.forName("com.example.MyImpl")，再调用其无参构造器
• 如果类不存在、无 public 无参构造、构造抛异常，next() 直接抛 ServiceConfigurationError
• 已加载过的实现类不会重复加载，但每次 next() 都新建实例（不是单例）

ClassLoader 用谁的？默认是当前线程上下文类加载器

ServiceLoader 构造时默认使用 Thread.currentThread().getContextClassLoader()，不是 ServiceLoader.class.getClassLoader()。这意味着：

• 在 Web 容器（如 Tomcat）中，若服务提供方 JAR 放在 WEB-INF/lib，而 SPI 接口在容器共享类路径，可能因类加载器隔离导致找不到实现类
• 显式指定类加载器可规避问题：ServiceLoader.load(Interface.class, myClassLoader)
• 模块化（Java 9+）环境下，服务提供者必须在 module-info.java 中声明 provides Interface with Impl;，否则即使配置文件存在也会被忽略

常见故障点：文件名拼错、类名拼错、没加 public 无参构造

最常卡在这三处，错误现象通常是 NoSuchElementException（迭代为空）或 ServiceConfigurationError: Provider xxx not found：

• 检查 META-INF/services/ 文件名是否与接口类全限定名一字不差（含包名）
• 检查文件内类名是否拼写正确、是否带包名、是否多写了分号或空格
• 确认实现类是 public 的，且存在 public 无参构造器（哪怕只是 public MyImpl() {}）
• 打包后用 jar -tf your.jar | grep services 确认文件确实被打进了 JAR 根路径

SPI 机制本身极简，但它的脆弱性全藏在这些细节里：不报错、不警告、只是默默不返回任何实现。调试时别猜，先翻 JAR 包里的 META-INF/services/。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《ServiceLoader机制解析与使用教程》文章吧，也可关注golang学习网公众号了解相关技术文章。