桥接方法是编译器自动生成的合成方法,用于解决泛型擦除后因签名不一致导致的重写失效问题;其签名匹配父类擦除后形式,方法体转发调用并隐式类型转换,标记为acc_bridge | acc_synthetic。

Java 泛型擦除后,桥接方法是编译器(javac)在检测到“逻辑上应构成重写,但擦除后签名不匹配”时,自动插入的合成方法。它不写在源码里,也不参与编译期重载解析,却真实存在于字节码中,专为保障多态调用正确性而生。
触发桥接方法生成的核心条件
只有同时满足以下三点,编译器才会生成桥接方法:
- 父类或接口中定义了带泛型参数的方法(如
abstract T get();或int compareTo(T o);) - 子类或实现类重写该方法,并将泛型具体化(如返回
String、参数用String、或实现Comparable<integer></integer>) - 类型擦除后,子类方法签名与父类/接口擦除后的签名不一致(比如返回类型从
Object变成String,或参数从Object变成Integer)
桥接方法长什么样?
以 Box<t></t> 和 StringBox extends Box<string></string> 为例:
父类源码:
abstract T get();
擦除后字节码签名:
Object get();
子类源码:
public String get() { return "ok"; }
擦除后字节码签名:
String get();
由于 String get() ≠ Object get(),JVM 不认为这是重写。于是编译器悄悄加一个桥接方法:
Java项目代码review工具。分析Git变更+完整调用链路上下文,推断业务需求,进行多维度评分和分类汇总,生成完整PRD文档。包含细粒度Java代码审查清单(Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
public Object get() { return this.get(); }
这个方法:
- 签名完全匹配父类擦除后形式(无参,返回
Object) - 方法体只做一件事:调用你写的
String get(),并隐式转为Object - 字节码标记为
ACC_BRIDGE | ACC_SYNTHETIC(可用javap -v查看)
不止返回类型,参数窄化也会触发
比如接口 Comparable<t></t> 擦除为 compareTo(Object),而 Integer 实现的是 compareTo(Integer)。编译器会生成:
public int compareTo(Object o) { return compareTo((Integer) o); }
这样,当 TreeSet 内部用 Comparable 引用调用时,就能正确分派到 Integer 的逻辑。
怎么确认桥接方法存在?
不能靠看 Java 文件,得查编译结果:
- 命令行执行:
javap -c -s StringBox,你会看到两个get方法:一个返回Ljava/lang/String;,另一个返回Ljava/lang/Object; - 反射中遍历:
method.isBridge()返回 true 的就是桥接方法 - 注意:桥接方法不可被
@Override标注,也不能手动重写或调用
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










