Java插件化核心是主程序仅依赖接口、运行时动态发现调用实现类，关键在于契约清晰（小而稳接口）、加载可控（SPI或SPI+Spring组合）、解耦彻底（二进制兼容与模块隔离）。
Java 中用接口实现插件化架构，核心不是“定义了接口”，而是让主程序只依赖接口、完全不知道插件的具体类名和包路径，所有实现类在运行时才被发现和调用。关键在于契约清晰、加载可控、解耦彻底。
定义小而稳的插件接口
接口是主程序与插件之间的唯一契约，必须聚焦“做什么”，避免掺杂实现细节：
- 方法职责单一，例如日志插件只提供
log(Level, String)和flush()，不包含配置加载、线程池管理等逻辑 - 参数优先使用不可变对象或轻量 DTO（如
OrderDTO），不传HttpServletRequest或ApplicationContext等框架强依赖类型 - 返回值语义明确，统一用封装类如
Result.success(data)或Result.fail(400, "timeout") - 接口发布后尽量不修改方法签名；需扩展时，用默认方法（Java 8+）或定义子接口（如
AsyncPlugin extends Plugin）
用 SPI（ServiceLoader）自动发现实现类
SPI 是 JDK 原生机制，适合轻量、稳定、无需 Spring 生命周期干预的插件场景：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 插件 JAR 包中必须包含
META-INF/services/com.example.Plugin文件（文件名=接口全限定名） - 该文件内写入实现类全限定名，每行一个，不能有空格、BOM 或空行，例如：
com.plugin.file.FileLogger - 主程序通过
ServiceLoader.load(Plugin.class)获取所有实现，支持findFirst()、stream().filter(...).toList()等操作 - 注意：ServiceLoader 创建的实例不经过 Spring 容器，
@Autowired和@PostConstruct不生效
结合 Spring 容器托管插件实例（推荐组合方式）
既想自动发现插件，又想享受 Spring 的依赖注入和 AOP，可采用“SPI 发现 + Spring 托管”策略：
立即学习“Java免费学习笔记（深入）”；
- 插件实现类仍标注
@Component，确保被 Spring 扫描到 - 主程序先用
ServiceLoader加载所有实现类的Class对象（只读类名，不实例化） - 再通过
applicationContext.getBean(clazz, Plugin.class)拿到已初始化、已代理、已注入的 Bean 实例 - 这样插件既能动态扩展，又能复用事务、缓存、日志等 Spring 能力
确保二进制兼容与模块隔离
插件与主程序之间必须共享同一份接口定义，否则类加载会失败：
- 把插件接口单独抽成一个 Maven 模块（如
plugin-api），主程序和所有插件都依赖它 - 插件 JAR 不打包
plugin-api，避免版本冲突；主程序 classpath 中只能存在一份接口定义 - 若需热更新或隔离类加载，可自定义
URLClassLoader加载插件 JAR，并设置 parent 为 AppClassLoader，避免污染主程序类空间
