使用URLClassLoader加载JAR类时出现NoClassDefFound异常

你的问题核心是URLClassLoader的父加载器配置错误，导致插件类依赖的package.Plugin接口无法被加载。当你用ClassLoader.getSystemClassLoader()作为父加载器时，系统类加载器可能无法访问到你的Plugin接口类（该接口通常存在于主程序的类路径中，而非系统类加载器默认覆盖的路径）。

关键修改点 #

1. 替换父加载器为当前类的类加载器 #

将创建URLClassLoader的代码：

val childClassLoader = URLClassLoader.newInstance(urls.toArray, ClassLoader.getSystemClassLoader)

改为：

val childClassLoader = URLClassLoader.newInstance(urls.toArray, getClass.getClassLoader)

这样URLClassLoader会优先从PluginManager所在的类加载器中加载Plugin接口，确保接口类能被正确找到。

2. 确保接口类的可见性 #

• 确认package.Plugin接口为public访问权限，插件类能正确实现它。
• 插件JAR中不要包含Plugin接口的副本，避免类加载冲突，接口应仅存在于主程序的类路径中。

完整修正后的代码片段 #

def loadPlugins(name : String) : AnalysisPlugin = {
  val classInfo : (ClassInfo,File) = pluginMap.getOrElse(name,throw new IllegalArgumentException(s"the plugin $name does not exist"))
  val urls : List[URL] = List(classInfo._2.toURI.toURL)
  // 使用当前类的类加载器作为父加载器
  val childClassLoader = URLClassLoader.newInstance(urls.toArray, getClass.getClassLoader)
  info(s"loading plugin ${classInfo._1.name}")
  val c: Class[_] = childClassLoader.loadClass(classInfo._1.name)
  assert(c.getConstructors.length == 1)
  c.getConstructors.head.newInstance().asInstanceOf[AnalysisPlugin]
}

额外注意事项 #

• 若插件依赖第三方库，需要将这些依赖JAR也加入URLClassLoader的URL列表，否则会触发其他NoClassDefFoundError。
• 可以用use方法管理URLClassLoader（Scala 2.13+支持），避免类加载器资源泄漏：

def loadPlugins(name : String) : AnalysisPlugin = {
  val classInfo : (ClassInfo,File) = pluginMap.getOrElse(name,throw new IllegalArgumentException(s"the plugin $name does not exist"))
  val urls : List[URL] = List(classInfo._2.toURI.toURL)
  URLClassLoader.newInstance(urls.toArray, getClass.getClassLoader).use { childClassLoader =>
    info(s"loading plugin ${classInfo._1.name}")
    val c: Class[_] = childClassLoader.loadClass(classInfo._1.name)
    assert(c.getConstructors.length == 1)
    c.getConstructors.head.newInstance().asInstanceOf[AnalysisPlugin]
  }
}

内容的提问来源于stack exchange，提问作者Sim