使用Reflections API从JAR加载带注解类时返回空集合问题求助

核心原因 #

你遇到的问题本质是类加载器的可见性或上下文不匹配：

• 虽然Reflections能扫描到JAR里带注解的类名，但调用asClass()时，默认使用的类加载器（可能是Maven插件自身的类加载器）无法加载目标JAR中的类；
• 或者你创建的urlClassLoader没有被Reflections正确用于类加载环节，导致转换失败。

可行解决方案 #

方案1：手动用指定类加载器加载类 #

既然能拿到正确的类名集合，直接跳过asClass()，用你自己的urlClassLoader手动加载类：

Set<String> classNames = reflections.get(Scanners.TypesAnnotated.with(MyAnnotation.class));
Set<Class<?>> classes = new HashSet<>();
for (String className : classNames) {
    try {
        Class<?> clazz = urlClassLoader.loadClass(className);
        classes.add(clazz);
    } catch (ClassNotFoundException e) {
        // 处理类加载失败的情况，比如日志打印
        e.printStackTrace();
    }
}

这种方式最直接，完全可控，避免Reflections内部类加载器的问题。

方案2：确保Reflections使用指定的类加载器进行转换 #

检查Reflections的asClass()方法是否支持指定类加载器，部分版本的Reflections允许在扫描器上绑定类加载器：

Set<Class<?>> classes = reflections.get(
    Scanners.TypesAnnotated.with(MyAnnotation.class)
                          .asClass(urlClassLoader) // 显式传入你的URLClassLoader
);

如果你的Reflections版本支持这个重载方法，这是最简洁的解决方式。

方案3：调整类加载器的双亲委派（谨慎使用） #

如果目标JAR中的类依赖插件环境中的类，可以把插件的类加载器设置为urlClassLoader的父类加载器，确保类加载的可见性：

// 创建URLClassLoader时指定父类加载器为当前类的类加载器（插件的类加载器）
URLClassLoader urlClassLoader = new URLClassLoader(urls, getClass().getClassLoader());

这种方式要注意避免类加载冲突，仅当你明确知道依赖关系时使用。

额外排查点 #

• 确认MyAnnotation类的类加载器与urlClassLoader的关系：如果注解是插件自身的类，目标类的注解实例由urlClassLoader加载，而你代码中的MyAnnotation.class由插件类加载器加载，这两个Class对象会被视为不同类。可以通过打印类加载器验证：

System.out.println(MyAnnotation.class.getClassLoader());
System.out.println(urlClassLoader);

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