Java Class-File API 如何重写方法的行号表属性

如果你需要给某个方法统一调整源码行号，入口不是直接拼接或替换 LineNumberTable 字节，而是把它当成 Class-File API 的代码元素来转换。Java 24 及以上版本中，LineNumberTable 会以 CodeModel 里的 LineNumber 伪指令呈现；重写时保留其他 CodeElement，遇到行号才调用 CodeBuilder.lineNumber(int)。

官方文档：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/classfile/package-summary.html

先把行号表看成 CodeModel 中的元素

ClassFile.parse 得到不可变的 ClassModel，方法下面还有 CodeModel。Oracle API 将行号记录作为代码遍历中的伪指令，因此不建议把 LineNumberTableAttribute.of(...) 直接塞回 CodeBuilder；正确的写入方式是按代码元素顺序重新调用 lineNumber。

用 CodeTransform 只改目标方法的行号

下面的示例把 targetMethod 的每个源码行整体后移 1000 行，其他方法不参与转换。这个偏移只是演示稳定的映射策略，生产环境可以换成按源码版本表查找的新行号。

import java.lang.classfile.ClassFile;
import java.lang.classfile.ClassTransform;
import java.lang.classfile.CodeElement;
import java.lang.classfile.CodeTransform;
import java.lang.classfile.MethodModel;
import java.lang.classfile.instruction.LineNumber;
import java.util.function.IntUnaryOperator;

static byte[] rewriteMethodLines(byte[] original, String methodName,
                                 IntUnaryOperator mapper) {
    // 解析后的模型只读；真正的改动在新的 builder 中完成。
    var classFile = ClassFile.of();
    var model = classFile.parse(original);

    CodeTransform lineTransform = (builder, element) -> {
        if (element instanceof LineNumber line) {
            // 只替换行号伪指令，当前位置和其他指令保持原顺序。
            builder.lineNumber(mapper.applyAsInt(line.line()));
        } else {
            // 普通指令、标签和异常信息继续透传，避免误删方法体。
            builder.with(element);
        }
    };

    ClassTransform classTransform =
        ClassTransform.transformingMethodBodies(
            (MethodModel method) -> method.methodName()
                .stringValue().equals(methodName),
            lineTransform);

    // 生成新的 class 字节；原始数组不会被原地修改。
    return classFile.transformClass(model, classTransform);
}

这里的关键是两个边界：方法谓词决定“改谁”，LineNumber 分支决定“改什么”。如果在 else 分支漏掉 builder.with(element)，方法体中的普通指令会被丢弃；如果不加方法谓词，则类中所有带代码的方法都会得到相同处理。

行号策略与 ClassFile 选项怎么选

最简单的策略是固定偏移，例如 line -> line + 1000；如果字节码来自插桩或源码重排，应使用原行号到新行号的明确映射表，而不是猜测字节码偏移。映射函数必须返回合法、可解释的源码行号，否则调试器虽然可能接受 class 文件，定位结果也会失真。

默认情况下，ClassFile.LineNumbersOption.PASS_LINE_NUMBERS 会处理行号。如果只是分析而不需要调试信息，可以在解析或生成上下文中选择丢弃行号；这会减少处理开销，但不改变运行时语义。注意，LineNumberTable 只服务于源码定位，不能用来修改异常控制流、分支条件或实际执行行。

var compactFile = ClassFile.of(
    ClassFile.LineNumbersOption.DROP_LINE_NUMBERS);
// 选择 DROP_LINE_NUMBERS 表示明确放弃行号信息，而不是重写它。
var model = compactFile.parse(originalBytes);

重写后先检查这几个边界

• 版本：Class-File API 从 Java 24 引入，运行环境低于 Java 24 时不能直接加载这组 API。
• 缺失调试信息：编译时没有生成行号表，转换器不会凭空制造原始源码位置；没有 LineNumber 时只会透传其他元素。
• 结构安全：如果同时改了指令、标签或栈映射，不要把“行号转换成功”当成 class 文件合法的证明。
• 验证：生成后可在隔离环境调用 ClassFile.verify，再交给目标类加载器或调试工具做兼容性检查。

实际项目中，行号重写通常应该和插桩规则放在同一份变换配置里：先锁定方法范围，再决定是否保留调试信息，最后记录原行号与新行号的映射。这样既能让调试器落到新的源码位置，也不会把行号属性误当成业务逻辑。

相关问题

直接构造 LineNumberTableAttribute 可以吗？

可以用它读取或描述行号表，但写入代码构建器时应按正确顺序调用 CodeBuilder.lineNumber。这能让行号和当前代码游标保持一致。

只想删除某个方法的行号怎么办？

仍然使用方法谓词限定范围，再在 CodeTransform 中忽略匹配的 LineNumber，其他元素继续 builder.with(element)。若整个类都不需要行号，才考虑 DROP_LINE_NUMBERS。