0

0

详解Java中的ServiceLoader类_实现SPI服务动态发现的核心类库

P粉602998670

P粉602998670

发布时间:2026-02-19 14:07:03

|

583人浏览过

|

来源于php中文网

原创

serviceloader.load() 找不到实现类的根本原因是其仅识别 meta-inf/services/ 下以接口全限定名命名的配置文件,且内容须为无空格、无注释、无多余换行的实现类全限定名;常见错误包括路径未打包、文件名错误、实现类非 public、java 9+ 模块中缺失 uses/provides 声明或 requires/export 不足。

详解java中的serviceloader类_实现spi服务动态发现的核心类库

ServiceLoader.load() 为什么总找不到实现类

根本原因不是代码写错了,而是 ServiceLoader.load() 只认 META-INF/services/ 下的配置文件,且文件名必须是接口全限定名,内容必须是实现类的全限定名(不能带空格、注释或多余换行)。常见错误包括:把配置文件放在 src/main/resources 但没打包进 jar;文件名写成 MyService 而不是 com.example.MyService;实现类没声明为 public;或者用了模块系统(Java 9+)却没在 module-info.java 中用 uses 声明依赖。

  • 确认 jar 包里真有 META-INF/services/com.example.MyService,用 jar -tf your.jar | grep services 检查
  • 配置文件内容只写一行:com.example.MyServiceImpl,末尾不要回车
  • 如果用 Maven,确保 resources 目录被正确包含,且没有被 filtering 意外修改
  • Java 9+ 模块中,服务提供方模块需在 module-info.javaprovides com.example.MyService with com.example.MyServiceImpl;

ServiceLoader.reload() 的实际作用很有限

reload() 不会重新扫描 classpath 或检测新 jar,它只是清空当前已缓存的实例列表,下次 iterator() 时会重新加载——但加载逻辑和首次一样,仍走原来的类加载器和已加载的 jar。它对热替换、插件动态更新毫无帮助。真正想做到运行时发现新实现,得自己配合文件监听 + 自定义 ClassLoader + 手动调用 ServiceLoader.load(..., newClassLoader)

  • reload() 后再遍历,只会重新实例化已知的那些实现类,不会发现新加入的 jar
  • 多次调用 load() 返回不同实例,但每个实例都来自同一个 ClassLoader,无法隔离
  • 若需插件热加载,别依赖 reload(),改用 URLClassLoader 加载外部 jar,再传给 ServiceLoader.load(service, classLoader)

ServiceLoader.iterator() 返回的 Iterator 不支持 remove()

调用 iterator().remove() 会直接抛 UnsupportedOperationException。这不是 bug,是设计使然:SPI 是只读发现机制,不提供运行时剔除某实现的能力。想跳过某个实现?只能在遍历时手动判断过滤,或提前用 StreamSupport.stream() 转成流再 filter()

超会AI
超会AI

AI驱动的爆款内容制造机

下载
  • 以下写法会崩溃:loader.iterator().remove()
  • 安全做法是收集后过滤:StreamSupport.stream(loader.spliterator(), false).filter(...).collect(...)
  • 注意 iterator() 是懒加载,每次调用都可能触发新实例化,避免反复遍历

Java 9+ 模块系统下 ServiceLoader 行为变化明显

模块路径(--module-path)取代 classpath 后,ServiceLoader 默认只查当前模块和其 requires 的模块,不再自动扫描所有 jar。如果服务接口在模块 A,实现类在模块 B,但 A 没 requires B,那 load() 就看不到 B 的实现——哪怕 jar 就在模块路径里。

立即学习Java免费学习笔记(深入)”;

  • 服务使用方模块(A)必须 requires 服务提供方模块(B),否则无法访问其实现类
  • 服务提供方模块(B)必须在 module-info.java 显式 exports 实现类所在包,并 provides 接口
  • 启动时若用 --class-path 混用传统 jar,模块系统会退化为 classpath 模式,但此时 ServiceLoader 可能漏掉模块路径里的实现
ServiceLoader 的核心约束始终没变:它只做静态发现,不管理生命周期,也不处理类加载隔离。最容易被忽略的是模块系统下的可见性规则——看似配置都对,实则败在 requires 缺失或 exports 不足。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

0

2025.09.15

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1529

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

423

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2260

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

37

2026.01.19

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

645

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

21

2025.12.06

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

660

2026.02.13

微博网页版主页入口与登录指南_官方网页端快速访问方法
微博网页版主页入口与登录指南_官方网页端快速访问方法

本专题系统整理微博网页版官方入口及网页端登录方式,涵盖首页直达地址、账号登录流程与常见访问问题说明,帮助用户快速找到微博官网主页,实现便捷、安全的网页端登录与内容浏览体验。

203

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 3.7万人学习

C# 教程
C# 教程

共94课时 | 9.8万人学习

Java 教程
Java 教程

共578课时 | 68.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号