Java中Class.getDeclaredMethods()返回重复方法名是因泛型擦除后编译器生成桥接方法所致，需通过isBridge()识别并过滤桥接方法，再按完整签名精准匹配真实方法。

Java 中通过桥接方法（Bridge Method）导致 Class.getDeclaredMethods() 返回重复方法名，是泛型擦除与编译器自动生成桥接方法共同作用的结果。这本身不是 bug，但若在反射调用中未加甄别，容易引发 IllegalArgumentException、重复调用或选错目标方法等问题。优化核心在于：**识别桥接方法、过滤冗余、精准定位真实实现方法**。

理解桥接方法为何导致“重复方法名”

当存在泛型类型擦除（如 List<String> → List）且子类重写父类泛型方法时，编译器会自动插入桥接方法（bridge），以保证多态调用正确性。该桥接方法与原始方法签名不同（参数/返回值被擦除），但方法名相同，且 isBridge() == true。例如：

// 编译后生成的桥接方法（不可见源码，但反射可见）
public Object get(int) { return this.get(int); } // 桥接方法，返回 Object
public String get(int) { ... } // 真实方法，返回 String

两者方法名均为 get，调用 getDeclaredMethods() 会同时返回，造成“重复方法名”假象。

实战中识别并过滤桥接方法

反射遍历时应主动排除桥接方法，避免干扰逻辑。关键判断依据是 Method.isBridge()：

• 直接过滤：Arrays.stream(clazz.getDeclaredMethods()).filter(m -> !m.isBridge()).toArray(Method[]::new)
• 配合 isSynthetic() 可进一步排除其他编译器生成方法（如 lambda 实现），但桥接方法不一定是 synthetic，isBridge() 才是权威标识
• 注意：不要仅靠方法名 + 参数数量做去重，因为桥接方法与原方法参数类型不同（如 Object vs String），仅比对名称会误判

按签名精准匹配目标方法（而非仅靠名字）

反射调用前，务必基于完整签名（方法名 + 参数类型数组）查找，而非只用方法名遍历：

• 使用 clazz.getDeclaredMethod("methodName", paramTypes...)，它自动跳过桥接方法，返回最匹配的真实方法
• 若需兼容重载，先获取所有非桥接方法，再用 Parameter.getType() 逐个比对参数类型是否可赋值（Class.isAssignableFrom()）
• 示例：想调用 set(String)，不要遍历所有 set 方法再手动筛选，而应明确传入 String.class 查找

缓存优化：避免重复解析桥接结构

对高频反射调用的类，可构建方法元信息缓存，一次性完成桥接识别与真实方法映射：

• 缓存结构建议：Map<String, Map<List<Class>, Method>>，外层 key 是方法名，内层 key 是参数类型列表（如 [String.class]），value 是对应真实 Method
• 构建时遍历 getDeclaredMethods()，跳过 isBridge() == true 的方法，其余按 getName() 和 getParameterTypes() 归类
• 后续调用直接查缓存，避免每次重复过滤和匹配，提升性能且逻辑稳定