桥接方法是java编译器为解决泛型擦除导致的多态失效而自动生成的合成方法,用于补全签名不一致、实现正确方法分派,具有acc_bridge标记且仅含类型转换与转发逻辑。

桥接方法(Bridge Method)是 Java 编译器在泛型类型擦除后,为保障多态正确性而自动生成的合成方法,主要出现在泛型类继承或实现泛型接口的场景中。它的核心作用是“补全因类型擦除导致的方法签名不一致”,确保子类重写父类/接口方法时,JVM 能正确分派调用。
为什么需要桥接方法?——类型擦除引发的签名冲突
Java 泛型是编译期特性,运行时会进行类型擦除。例如:
interface Comparable<t> {
int compareTo(T o);
}
class Integer implements Comparable<integer> {
public int compareTo(Integer o) { ... }
}</integer></t>
擦除后,接口变为 Comparable,方法变为 compareTo(Object);而子类实际声明的是 compareTo(Integer)。这两个方法参数类型不同,JVM 认为它们不是重写关系,导致多态失效(比如把 Integer 放入 TreeSet 会报 ClassCastException)。桥接方法正是为解决这一问题而生。
桥接方法的生成条件
编译器会在以下情况自动生成桥接方法:
- 子类(或实现类)重写了父类/接口中带泛型参数的方法,且重写后方法的参数类型被具体化(如
T → String) - 擦除后,子类方法签名与父类方法签名不一致(主要是参数类型、返回类型不同)
- 该方法需满足“可被多态调用”的语义要求(即外部可通过父类引用调用到子类逻辑)
桥接方法长什么样?——典型结构与特征
以 ArrayList<string></string> 继承 AbstractList<string></string> 中的 set(int, String) 为例:
- 父类擦除后方法签名:
Object set(int, Object) - 子类实际实现:
String set(int, String) - 编译器插入桥接方法:
public Object set(int index, Object element) {
return set(index, (String) element); // 转发给真实方法
}
这个桥接方法具有如下特征:
- 修饰符与子类真实方法一致(如
public) - 签名与父类擦除后方法完全一致(参数和返回类型均为擦除类型)
- 方法体只做类型转换 + 转发,无业务逻辑
- 被标记为
ACC_BRIDGE | ACC_SYNTHETIC(可通过javap -v查看)
返回类型协变也会触发桥接
不仅参数类型变化会触发,返回类型泛型擦除不一致同样会生成桥接方法。例如:
abstract class Box<t> {
abstract T get();
}
class StringBox extends Box<string> {
public String get() { return "ok"; }
}</string></t>
擦除后,父类方法为 Object get(),子类为 String get()。由于返回类型不同(JVM 方法签名包含返回类型),编译器会生成桥接方法:
public Object get() {
return get(); // 调用 String get()
}
这保证了通过 Box> 引用调用 get() 时,仍能正确绑定到 StringBox 的实现。
桥接方法是泛型与 JVM 类型系统妥协的结果,它透明存在、由编译器维护,开发者通常无需手动编写,但理解其生成逻辑有助于排查 ClassCastException、反射调用失败或字节码分析异常等问题。







