Java插件化必须用接口而非抽象类，因类加载器隔离下抽象类易引发NoClassDefFoundError，而接口仅约定签名、跨loader安全；宿主应提供纯接口jar，插件编译依赖但运行时由宿主加载；动态加载需设宿主类加载器为parent并正确管理上下文类加载器；实例化时接口必须由宿主加载，否则强转将触发ClassCastException；卸载本质是丢弃ClassLoader引用并确保无残留引用，否则导致内存泄漏。
Java插件化为什么必须用接口而不是抽象类
因为插件的类加载器和宿主不同，抽象类会强制绑定编译期的类路径，一旦插件里继承了宿主里的抽象类，就可能触发 NoClassDefFoundError 或 ClassNotFoundException——尤其在 OSGi、自定义 URLClassLoader 场景下更明显。接口只约定方法签名，不携带实现和静态字段，跨类加载器边界最安全。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 宿主项目只提供纯接口（无默认方法、无静态字段），打成独立
api.jar - 插件模块依赖该
api.jar编译，但运行时不打包进去，靠宿主类加载器提供 - 避免在接口中使用
default方法——某些老版本 JDK 或热加载框架（如 JRebel）对跨 loader 的 default 方法支持不稳定
动态加载插件 Jar 的正确姿势：URLClassLoader + 线程上下文类加载器
直接 new 一个 URLClassLoader 很容易踩坑：它默认父加载器是 AppClassLoader，而插件需要能访问宿主的接口类，所以必须把宿主的类加载器设为 parent；同时，很多框架（比如 Spring、Jackson）内部会调用 Thread.currentThread().getContextClassLoader()，不设置会导致反序列化失败或 SPI 查找不到。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 创建插件类加载器时显式传入宿主类加载器：
new URLClassLoader(urls, Thread.currentThread().getContextClassLoader()) - 加载前临时替换线程上下文类加载器：
Thread.currentThread().setContextClassLoader(pluginClassLoader)，用完记得恢复 - 不要复用同一个
URLClassLoader实例加载多个插件——类名冲突、静态变量污染、卸载困难 - JDK 9+ 注意
URLClassLoader不再是ClassLoader的默认实现，但兼容性仍好；若用模块系统，需额外导出包（opens/exports）
如何安全地实例化插件类并避免 ClassCastException
常见错误是用插件类加载器加载接口类，再用它加载实现类，最后强转——这会导致两个“同名接口”被不同类加载器加载，JVM 视为完全不同的类型，抛 ClassCastException。关键点在于：接口类必须由宿主类加载器加载，实现类才可被安全 cast。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 宿主侧用
Class.forName("com.example.PluginInterface", true, hostClassLoader)显式加载接口 - 插件侧实现类必须实现这个“宿主加载的接口”，不能重新 import 同名接口再实现（否则编译期看似一样，运行期不是同一 Class 对象）
- 反射获取构造器后，用
constructor.newInstance()创建实例，再用宿主加载的接口类型接收：PluginInterface plugin = (PluginInterface) instance - 如果插件需访问宿主服务，建议通过构造器注入或 setter 注入宿主对象，避免插件反向依赖宿主类加载器
插件卸载与内存泄漏的现实约束
Java 没有标准 API 卸载单个类或类加载器。所谓“卸载插件”，本质是丢弃 URLClassLoader 引用 + 等待 GC。但只要还有任何地方持有该 loader 加载的类的实例、静态引用、线程栈帧、JNI 全局引用，它就无法回收——最终导致 PermGen / Metaspace 溢出。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 插件实现必须主动清理资源：关闭线程池、注销监听器、释放 NIO Buffer、断开数据库连接
- 避免在插件中使用
static字段缓存宿主对象（尤其是ApplicationContext、Logger） - 检查第三方库是否注册了 shutdown hook 或 MBean，它们常隐式持有了类加载器引用
- 生产环境别指望“热卸载”100% 可靠；更务实的做法是进程级隔离（如插件跑在独立子进程），或接受有限次数的 reload
真正难的从来不是怎么加载，而是怎么确保所有引用都被切断——连日志框架的异步队列、定时任务的 ScheduledFuture，都可能悄悄拖住整个类加载器树。
