通过Java agent反射获取SWT类报ClassNotFoundException问题问询

算力阿峰

2026-9-27

问题产生原因

Eclipse基于OSGi模块化框架实现，每个插件都使用独立的类加载器隔离自身依赖：

org.eclipse.swt相关类属于SWT插件的私有类路径，仅对SWT插件的类加载器可见
你通过Attach API注入的Java agent默认使用系统类加载器/引导类加载器，该类加载器的类路径不包含SWT插件的资源，直接调用Class.forName("org.eclipse.swt.widgets.Display")自然会抛出ClassNotFoundException
就算你尝试使用当前线程上下文类加载器加载，默认附着时的上下文也不是SWT插件的类加载器，同样无法加载目标类

解决方法

你可以借助agent注入时拿到的Instrumentation实例遍历JVM已加载的所有类，直接获取已经被SWT插件加载的Display类和对应的类加载器，不需要主动触发类加载：

遍历所有已加载类定位Display类

Class<?> displayClazz = null;
ClassLoader swtClassLoader = null;
// instrumentation是agent入口premain/agentmain方法传入的实例
for (Class<?> clazz : instrumentation.getAllLoadedClasses()) {
    if ("org.eclipse.swt.widgets.Display".equals(clazz.getName())) {
        displayClazz = clazz;
        swtClassLoader = clazz.getClassLoader();
        break;
    }
}
// 处理SWT未初始化的场景：Eclipse刚启动UI还没加载时，可增加延迟重试逻辑
if (displayClazz == null) {
    return;
}

反射获取Display实例调度UI线程任务

// 获取默认Display实例
Method getDefaultMethod = displayClazz.getMethod("getDefault");
Object displayInstance = getDefaultMethod.invoke(null);

// 向UI线程提交异步任务
Method asyncExecMethod = displayClazz.getMethod("asyncExec", Runnable.class);
asyncExecMethod.invoke(displayInstance, (Runnable) () -> {
    // 此处填写需要在UI线程执行的逻辑
});

后续如果需要加载其他SWT相关类，统一使用上面拿到的swtClassLoader加载即可：

Class<?> otherSwtClazz = Class.forName("org.eclipse.swt.widgets.Shell", true, swtClassLoader);

注意事项

注入时机如果过早，Eclipse UI还未完成初始化时Display类还没被加载，需要增加轮询重试逻辑，间隔几百毫秒再扫描已加载类即可
UI线程提交任务不要执行耗时逻辑，否则会直接卡住Eclipse界面，符合SWT单线程UI模型的通用要求
不要尝试修改SWT类加载器的结构，避免破坏Eclipse的OSGi模块化隔离规则导致IDE崩溃

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