反射调用失败的根本原因是方法签名不匹配，需严格核对方法名、参数类型（区分基本类型与包装类、泛型擦除）、访问权限，并正确选用getmethod或getdeclaredmethod，配合setaccessible(true)调用私有方法，同时做好异常处理与缓存优化。
这个问题本质不是“方法丢了”，而是反射时传入的查找条件和类里实际定义的方法签名对不上。关键就三点：方法名、参数类型、访问权限，三者必须严丝合缝。
方法名和参数类型必须完全一致
Java反射对大小写和类型是零容忍的。比如目标方法是 public void setName(String name)：
- setName 写成 setname 或 Setname —— 错
- 传 Object.class 代替 String.class —— 错（即使 String 是 Object 子类）
- 传 int.class 但方法要 Integer —— 错（基本类型和包装类不等价）
- 方法没参数却写了 String.class —— 错
建议直接从 IDE 里复制方法声明中的参数类型，别手敲。不确定时，先打印 clazz.getDeclaredMethods() 看真实列表。
public 和非 public 方法要用不同 API
getMethod 只能查到 public 方法，包括父类继承来的；private、protected、包级私有方法一律查不到。
- 调 private void init(Config c)，必须用 getDeclaredMethod("init", Config.class)
- 紧接着加 method.setAccessible(true) 才能调用
- 注意：getDeclaredMethod 不跨类，父类的 private 方法得在父类上查
确认方法真在那个类里
常见误判场景：
- 方法在子类，却去父类反射 —— 查不到
- 泛型方法如
T parse(String s) ，反射时参数按擦除后算，用 String.class，不是 Class.class - 接口 default 方法可用 getMethod 查，但得确保接口已加载且实现类没覆盖
- 内部类方法，需用 Outer$Inner.class 而非 Outer.class
把异常当正常流程来设计
反射本身就有不确定性，别让程序卡在异常上：
- 用 try-catch 捕获 NoSuchMethodException，走默认逻辑或返回空值
- 高频调用场景，提前缓存 Method 对象，避免重复查找开销
- 封装工具方法，返回 Optional
，调用方显式判断是否存在 - 加日志记录失败时的类名、方法名、参数类型，方便排查
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
