桥接方法是编译器为支持泛型多态性生成的辅助方法，用于桥接泛型签名与擦除后的原始类型签名；其标志为isBridge()返回true，仅出现在泛型类/接口的实例方法实现中。
什么是桥接方法（Bridge Method）
桥接方法是编译器为支持泛型多态性而自动生成的辅助方法。当你用泛型类实现接口或继承泛型父类时，Java 编译器会额外生成一个签名“擦除后”的方法，用来桥接原始泛型方法与运行时 JVM 所需的原始类型签名。
例如：
接口定义：interface Container
实现类：class StringContainer implements Container
编译后，StringContainer 实际包含两个 set 方法：
- public void set(String s) —— 你写的原方法
- public void set(Object o) —— 编译器插入的桥接方法，内部调用 set(String)
这个桥接方法的存在，是为了让 JVM 在运行时能通过 Container 接口引用（如 Container c = new StringContainer()）正确调用 set，即使接口方法声明的是 void set(T)。
反射中为什么容易误匹配桥接方法
反射 API 默认按签名查找方法，而 getDeclaredMethod("set", Object.class) 或 getMethod("set", Object.class) 很可能返回桥接方法，而非你期望的原始泛型实现方法。
后果包括：
- 调用时传入 String，却因桥接方法接受 Object 而看似成功，但后续逻辑可能出错（比如方法体内强转失败）
- 获取参数类型时得到 Object.class，无法还原真实泛型约束
- 对重载方法做泛型推断时，桥接方法干扰筛选结果，导致 AmbiguousMatchException
如何精准定位非桥接的目标方法
关键不是“避开”桥接方法，而是识别并过滤它。JVM 为桥接方法设置了 isBridge() == true 标志，这是最可靠、最轻量的判断依据。
推荐做法：
- 用 getMethods() 或 getDeclaredMethods() 获取全部同名方法
- 遍历筛选：保留 !m.isBridge() && m.getName().equals("methodName")
- 再结合参数类型进一步匹配（注意用擦除后的 getParameterTypes()，不是泛型信息）
示例代码片段：
Method target = Arrays.stream(clazz.getMethods())
.filter(m -> "set".equals(m.getName()))
.filter(m -> !m.isBridge())
.filter(m -> m.getParameterCount() == 1 && m.getParameterTypes()[0] == String.class)
.findFirst()
.orElseThrow();
桥接方法 ≠ 泛型方法，别混淆两者
一个常见误区是认为“泛型方法一定有桥接方法”。其实：
- 泛型方法（如
T get() ）本身不会生成桥接方法；桥接方法只出现在泛型类型（类/接口）的实例方法实现中 - 桥接方法永远是 public，且参数/返回值被擦除为上界（通常是 Object），不带泛型签名
- 若目标方法是 static 或 private，不会产生桥接方法
所以，检查 isBridge() 前，先确认你操作的是泛型类的实例方法实现，而不是泛型方法本身。
