Java运行时类插桩报错：插入栈帧偏移与现有帧重叠

问题根源 #

出现帧偏移重叠的核心原因是手动插桩时未正确处理指令长度变化对StackMapTable的影响：

• 在方法开头插入try块相关指令（如标记起始位置、跳转指令）后，原有方法的所有指令会向后偏移，但原有StackMapTable中帧的偏移量未被更新，仍保留旧位置。
• 新增catch块的帧偏移计算错误，未基于插入后的总指令长度计算，最终与原有帧的偏移（如你遇到的73）重叠，触发JVM字节码验证失败。
• 未借助ASM提供的自动帧计算工具，手动维护StackMapTable时极易忽略指令长度的累加，导致偏移计算失误。

解决方案 #

1. 改用ASM的AdviceAdapter实现插桩 #

ASM的AdviceAdapter专为方法前后插桩设计，会自动处理指令偏移的累加，配合ClassWriter.COMPUTE_FRAMES可让ASM自动生成正确的StackMapTable，彻底避免手动计算偏移的错误。

示例代码：

import org.objectweb.asm.ClassVisitor;
import org.objectweb.asm.MethodVisitor;
import org.objectweb.asm.Opcodes;
import org.objectweb.asm.commons.AdviceAdapter;

public class GlobalTryCatchClassVisitor extends ClassVisitor {
    public GlobalTryCatchClassVisitor(int api, ClassVisitor cv) {
        super(api, cv);
    }

    @Override
    public MethodVisitor visitMethod(int access, String name, String descriptor, String signature, String[] exceptions) {
        MethodVisitor mv = super.visitMethod(access, name, descriptor, signature, exceptions);
        // 按需跳过构造方法、静态初始化方法
        if (!name.equals("<init>") && !name.equals("<clinit>")) {
            mv = new GlobalTryCatchMethodAdapter(Opcodes.ASM9, mv, access, name, descriptor);
        }
        return mv;
    }

    static class GlobalTryCatchMethodAdapter extends AdviceAdapter {
        private final Label tryStart = new Label();
        private final Label tryEnd = new Label();
        private final Label catchHandler = new Label();
        private final Label catchEnd = new Label();

        protected GlobalTryCatchMethodAdapter(int api, MethodVisitor mv, int access, String name, String desc) {
            super(api, mv, access, name, desc);
        }

        @Override
        protected void onMethodEnter() {
            // 标记try块起始位置
            mark(tryStart);
        }

        @Override
        protected void onMethodExit(int opcode) {
            // 正常返回时标记try块结束
            if (opcode != ATHROW) {
                mark(tryEnd);
                // 跳转至catch块后，避免正常执行进入catch逻辑
                visitJumpInsn(GOTO, catchEnd);
            }

            // 标记catch块起始位置
            mark(catchHandler);
            // 捕获Throwable并重新包装抛出（可按需调整异常类型）
            visitTypeInsn(NEW, "java/lang/RuntimeException");
            visitInsn(DUP);
            visitSwap();
            visitMethodInsn(INVOKESPECIAL, "java/lang/RuntimeException", "<init>", "(Ljava/lang/Throwable;)V", false);
            visitInsn(ATHROW);

            // 标记catch块结束
            mark(catchEnd);
            // 注册try-catch块，指定捕获的异常类型
            visitTryCatchBlock(tryStart, tryEnd, catchHandler, "java/lang/Throwable");
        }
    }
}

2. 正确配置ClassWriter #

创建ClassWriter时必须指定ClassWriter.COMPUTE_FRAMES，让ASM自动重新计算所有StackMap帧的位置和内容，不要依赖原有类的StackMapTable：

ClassWriter cw = new ClassWriter(ClassWriter.COMPUTE_FRAMES);
GlobalTryCatchClassVisitor cv = new GlobalTryCatchClassVisitor(Opcodes.ASM9, cw);
// 读取原有类字节码并交由自定义ClassVisitor处理
classReader.accept(cv, ClassReader.EXPAND_FRAMES);

3. 避免手动修改StackMapTable #

除非对JVM字节码的StackMapTable格式、指令长度计算有深入理解，否则不要手动处理visitFrame方法。ASM的自动计算功能已能覆盖绝大多数场景，手动修改极易出错。

关键注意点 #

• 使用最新版本的ASM（如ASM9），旧版本在StackMapTable自动计算上可能存在bug。
• 插桩时跳过特殊方法（如<init>、<clinit>），这类方法字节码结构特殊，盲目插桩易引发其他错误。
• 重新抛出异常时注意异常类型的兼容性，避免破坏原有方法的异常声明。

内容的提问来源于stack exchange，提问作者Instein