桥接方法是java编译器为泛型和协变返回类型生成的合成方法，需在字节码插桩时识别acc_bridge标志并跳过增强，仅对非桥接非合成方法插桩，以避免重复计时、参数提取失败或jvm验证错误。
桥接方法（Bridge Method）是 Java 编译器为支持泛型、协变返回类型等特性自动生成的合成方法，它本身不显式出现在源码中，却真实存在于字节码里。在动态字节码修改（如 ASM 或 ByteBuddy 插桩）过程中，若未识别并特殊处理桥接方法，极易导致监控探针注入失败、重复方法定义（ClassFormatError: Duplicate method name）、或关键业务方法被意外跳过——这在线上系统中会直接造成监控盲区或 JVM 启动崩溃。
识别桥接方法：不能只靠方法名和描述符
桥接方法与原始方法通常共享相同名称和逻辑语义（如 get()），但 descriptor 不同（例如 Object get() vs String get()），且带有 ACC_BRIDGE | ACC_SYNTHETIC 标志。仅靠 "get".equals(name) 判断会误命中桥接方法；必须同时校验访问标志：
- 在
ClassVisitor.visitMethod中，检查access & Opcodes.ACC_BRIDGE是否非零 - 跳过对桥接方法的 instrument 操作（不调用
instrument(mv)），也不返回null阻断它——否则会破坏泛型多态调用链 - 保留桥接方法原样透传：
return super.visitMethod(...)
避免桥接方法干扰增强逻辑注入点
监控探针常需在目标方法入口/出口插入计时、参数采集等逻辑。若将增强逻辑错误注入桥接方法，会导致：
- 同一业务逻辑被重复计时（桥接方法调用原始方法，两者都被插桩）
- 参数提取失败（桥接方法参数类型与原始方法不一致，如
ObjectvsString） - JVM 验证失败（因桥接方法签名由编译器严格生成，擅自改写 descriptor 易触发校验异常）
正确做法是：只对非桥接、非合成的目标方法（即 !isBridge && !isSynthetic）执行完整插桩；对桥接方法不做任何字节码变更，仅允许其作为“透明通道”转发调用。
兼容泛型擦除后的字节码结构一致性
Java 泛型在运行时被擦除，桥接方法正是编译器为弥补擦除后类型安全而插入的“适配器”。插桩工具若未按 JVM 规范保留桥接方法的完整结构（包括其 Signature 属性、异常表、局部变量表索引），可能引发：
- 反射调用失败（
Method.isBridge()返回true，但实际字节码缺失桥接特征） - Spring AOP 等框架代理失效（依赖准确识别桥接关系构建代理链）
- 某些 JDK 版本（如 17+）在类验证阶段拒绝加载非法桥接方法
建议在 MethodVisitor 处理完毕后，使用 CheckClassAdapter 对修改后的类做预验证，重点确认桥接方法仍满足：ACC_BRIDGE 和 ACC_SYNTHETIC 同时存在、descriptor 符合桥接语义、无非法指令插入。
线上探针启动阶段主动过滤桥接类路径
部分高频被增强的类（如 Spring Bean、JDK Collections 工具类）含有大量桥接方法。可在 ClassFileTransformer.transform 中前置扫描类结构，快速判断是否含桥接方法且无需监控（例如 java.util.ArrayList 的泛型桥接方法）：
- 通过
ClassReader读取visitMethod事件，统计ACC_BRIDGE方法数量 - 若全类仅含桥接方法（无普通业务方法），直接返回
null跳过 transform，节省 CPU 与内存开销 - 该策略可降低探针在 JDK 基础类上的插桩压力，提升启动速度与稳定性
