getSuperClass()抛出异常但getSuperclassName()可正常返回父类名

使用JavaClass API开发时执行如下代码：

System.out.println(javaClass.getSuperclassName());
JavaClass javaClass1 = javaClass.getSuperClass();

其中第一行代码可以正常输出父类名称RestController，第二行代码执行时抛出如下异常：

java.lang.ClassNotFoundException: Exception while looking for class example.RestController: java.io.IOException: Couldn't find: example/RestController.class

核心原因是两个API的底层实现逻辑完全不同：

• getSuperclassName() 仅从当前已经加载完成的目标类的字节码常量池中，直接读取存储的父类全限定名字符串，整个过程不需要查找、加载父类对应的字节码文件。因此只要目标类本身解析正常，哪怕父类不在类库的搜索路径中，也能正常返回父类名称。
• getSuperClass() 需要返回父类对应的完整JavaClass实例，这一步会触发类库的类资源查找逻辑，必须在配置的类搜索路径下找到父类对应的class字节码文件才能完成实例构建。报错信息明确提示找不到example/RestController.class，说明example.RestController类的存放路径没有被加入JavaClass类库的搜索范围，类库仅拿到了父类的名称，无法定位到实际的字节码资源，因此抛出类找不到异常。

• 补全类搜索路径：先定位example.RestController对应的class文件实际存放位置，将该类所在的class输出根目录、或者依赖的jar包添加到JavaClass类库的类搜索路径配置中。注意不要仅添加当前待分析的目标类路径，需要把目标类依赖的所有父类、关联类的存放路径都覆盖到；同时要保证包名和目录层级严格匹配，example.RestController必须对应搜索路径下的example/RestController.class文件，不能出现目录层级和包名不匹配的问题。
• 按需调用API：如果业务场景仅需要获取父类名称，不需要解析父类的字段、方法、注解等字节码结构，直接调用getSuperclassName()获取字符串结果即可，不需要调用getSuperClass()触发类资源查找逻辑，从根源避免该异常。

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