当使用多个独立的 URLClassLoader 实例分别加载不同模块时，由于类加载器实例隔离，模块间无法互相访问对方的类；统一复用同一个 URLClassLoader 实例可打破此隔离，实现模块间类可见性。
当使用多个独立的 `urlclassloader` 实例分别加载不同模块时，由于类加载器实例隔离，模块间无法互相访问对方的类；统一复用同一个 `urlclassloader` 实例可打破此隔离，实现模块间类可见性。
在基于模块化插件架构的 Java 应用中，常通过自定义 ClassLoader 动态加载外部 JAR 模块（如 Module A 和 Module B）。一个典型误区是：每次调用 loadClass() 时都新建一个 URLClassLoader，例如：
// ❌ 错误做法：每次创建新实例 → 导致类空间隔离 URLClassLoader loaderA = new URLClassLoader(urlsA, parent); URLClassLoader loaderB = new URLClassLoader(urlsB, parent); // 与 loaderA 无关联
由于每个 URLClassLoader 实例维护独立的类命名空间，且彼此不构成双亲委派链中的父子关系，Module B 的类加载器无法委托或感知 Module A 加载的类，因此抛出 ClassNotFoundException。
✅ 正确做法是全局复用同一个 URLClassLoader 实例，确保所有模块共享同一类加载上下文：
// ✅ 正确：单例式共享 ClassLoader
private static final URLClassLoader SHARED_MODULE_LOADER;
static {
try {
SHARED_MODULE_LOADER = new URLClassLoader(new URL[0],
Thread.currentThread().getContextClassLoader());
} catch (Exception e) {
throw new RuntimeException("Failed to initialize shared module classloader", e);
}
}
// 加载模块时复用该实例
public <T> T loadModuleClass(String className, List<URL> jarUrls, Class<T> expectedType)
throws ClassNotFoundException, InstantiationException, IllegalAccessException {
// 动态添加 JAR 路径（Java 9+ 推荐使用 addURL via reflection 或迁移到 Layer API）
for (URL url : jarUrls) {
addURLToClassLoader(SHARED_MODULE_LOADER, url); // 需反射调用 addURL()
}
return expectedType.cast(SHARED_MODULE_LOADER.loadClass(className).getDeclaredConstructor().newInstance());
}⚠️ 注意事项：
URLClassLoader.addURL()是protected方法，需通过反射调用（Java 8 及以下兼容）；Java 9+ 建议考虑Layer+Configuration模块化方案替代传统类加载器；- 确保
SHARED_MODULE_LOADER的父加载器为应用核心类加载器（如Thread.currentThread().getContextClassLoader()），以保障对核心 API 的可见性；- 若模块存在版本冲突或需严格隔离，应改用
ClassLoader层级隔离设计（如 OSGi、JPMS），而非共享加载器。
总结：模块间类可见性的本质是类加载器的命名空间一致性。避免“一次一建”，坚持“一器多用”，即可让 Module A 与 Module B 在同一运行时环境中无缝互调——这是轻量级插件系统稳定协作的关键基础。
