【修BUG】java.lang.NoClassDefFoundError: org/eclipse/jgit/transport/CredentialsProvider

现场

当前环境： 编辑器使用的是 Eclipse Lula ，Java 采用 JDK 8 。这是一个RCP 开发，当前需求是使用 EGit 编写一些有关Git操作的业务。

正常情况下是 Eclipse 中安装 Egit 插件，然后再 plugin.xml 中引入响应的依赖。

但是这里没有，这里采用引入jar包的方式来添加依赖。即将 jar 包放到了lib 包中，并添加到了 classpath 。

然而使用时却抛出了如下异常：

!ENTRY org.eclipse.ui 4 0 2023-04-26 10:15:16.326
!MESSAGE Unhandled event loop exception
!STACK 0
java.lang.NoClassDefFoundError: org/eclipse/jgit/transport/CredentialsProvider
	at com.xzbd.GitTool.action.PublishCodeHelper.pushCode(PublishCodeHelper.java:53)
	at com.xzbd.GitTool.action.PublishCodeHelper.publish(PublishCodeHelper.java:41)
	at com.xzbd.GitTool.action.PublishCodeAction.run(PublishCodeAction.java:49)
	at org.eclipse.jface.action.Action.runWithEvent(Action.java:519)
	at org.eclipse.jface.action.ActionContributionItem.handleWidgetSelection(ActionContributionItem.java:595)
	at org.eclipse.jface.action.ActionContributionItem.access$2(ActionContributionItem.java:511)
	at org.eclipse.jface.action.ActionContributionItem$5.handleEvent(ActionContributionItem.java:420)
	at org.eclipse.swt.widgets.EventTable.sendEvent(EventTable.java:84)
	at org.eclipse.swt.widgets.Display.sendEvent(Display.java:4454)
	at org.eclipse.swt.widgets.Widget.sendEvent(Widget.java:1388)
	at org.eclipse.swt.widgets.Display.runDeferredEvents(Display.java:3799)
	at org.eclipse.swt.widgets.Display.readAndDispatch(Display.java:3409)
	at org.eclipse.e4.ui.internal.workbench.swt.PartRenderingEngine$9.run(PartRenderingEngine.java:1151)
	at org.eclipse.core.databinding.observable.Realm.runWithDefault(Realm.java:332)
	at org.eclipse.e4.ui.internal.workbench.swt.PartRenderingEngine.run(PartRenderingEngine.java:1032)
	at org.eclipse.e4.ui.internal.workbench.E4Workbench.createAndRunUI(E4Workbench.java:148)
	at org.eclipse.ui.internal.Workbench$5.run(Workbench.java:636)
	at org.eclipse.core.databinding.observable.Realm.runWithDefault(Realm.java:332)
	at org.eclipse.ui.internal.Workbench.createAndRunWorkbench(Workbench.java:579)
	at org.eclipse.ui.PlatformUI.createAndRunWorkbench(PlatformUI.java:150)
	at com.xzbd.GitTool.Application.start(Application.java:20)
	at org.eclipse.equinox.internal.app.EclipseAppHandle.run(EclipseAppHandle.java:196)
	at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runApplication(EclipseAppLauncher.java:134)
	at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:104)
	at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:380)
	at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:235)
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
	at java.lang.reflect.Method.invoke(Method.java:483)
	at org.eclipse.equinox.launcher.Main.invokeFramework(Main.java:648)
	at org.eclipse.equinox.launcher.Main.basicRun(Main.java:603)
	at org.eclipse.equinox.launcher.Main.run(Main.java:1465)
	at org.eclipse.equinox.launcher.Main.main(Main.java:1438)
Caused by: java.lang.ClassNotFoundException: org.eclipse.jgit.transport.CredentialsProvider cannot be found by com.xzbd.GitTool_1.0.0.qualifier
	at org.eclipse.osgi.internal.loader.BundleLoader.findClassInternal(BundleLoader.java:432)
	at org.eclipse.osgi.internal.loader.BundleLoader.findClass(BundleLoader.java:345)
	at org.eclipse.osgi.internal.loader.BundleLoader.findClass(BundleLoader.java:337)
	at org.eclipse.osgi.internal.loader.ModuleClassLoader.loadClass(ModuleClassLoader.java:160)
	at java.lang.ClassLoader.loadClass(ClassLoader.java:357)
	... 34 more

分析

java.lang.NoClassDefFoundError异常意味着某个类被JVM成功加载,但是在使用时找不到其对应Class字节码。对此异常的处理主要有以下几步:

1. 检查依赖关系是否完成。通常使用Java反射机制,在程序运行期间去引入更多的jar包或修改类路径,导致某些依赖关系找不到对应jar包。需要确保所有需要使用到的jar包都已经引入。

2. 确保所有jar包都正常安装、没有损坏。可以重新下载所有jar包再安装。

3. 确保类在jar包中正常存在。有可能是在将某个类引入某个jar包时,由于某种原因这个class字节码并不正常存在于jar包中,导致不可用。

4. 确保所有jar包的版本兼容,避免同一包存在多个版本。可以通过maven依赖管理等工具解析所有jar包的依赖关系,发现潜在的依赖冲突。

5. 重新启动应用服务器。有些情况下,某些jar包没有正常解压,修改了部分内容后没有刷新,重启可以重新加载所有jar包。

6. 利用断点调试,逐步向上追溯找出root cause。如果其他手段不知何故仍无法解决,可以通过在关键点下定义断点来逐步调试从而找到异常发生的原因。

7. 根据情况使用反射、代理机制,进行救急处理。作为最后手段,可以考虑使用反射创建指定类的实例,或使用代理引导请求流向可用类,暂时规避异常。但这只是应急手段,还是需要修复根本原因。

虽然方案很多，但非常遗憾依然不是没有解决。

解决方案

1、打开 plugin.xml ， 跳转到 Runtime 视图

2、点击 Add 添加 缺失的包

总结

根据网上资料分析，在项目启动成功，但在运行时报 NoClassDefFoundError 的异常，建议先查看运行时编译的文件中是否有导入的包信息，然后根据场景分析，找到问题突破点。