外观
09 - 类文件与字节码:从产物到调用契约
基线:JVMS 17 与 javac 8/17。javac 的输出策略不是所有语言编译器必须采用的 JVM 规则。
阅读指引
- 本文定位:执行链中“源码 → class 产物 → 调用契约”的桥梁;编号 09 不意味着应在调优之后阅读。
- 前置阅读:01 内存布局提供栈帧、局部变量表与操作数栈的运行时地图。
- 后续阅读:03 类加载解释符号引用如何进入类型身份、链接与初始化;随后读 02 对象创建与分配。
- 学习目标与排障:能从 javap 产物指出描述符、调用点和验证信息,并区分源码兼容与二进制兼容;线上实际加载的类型与方法需结合 B Arthas取证。
摘要
源码里方法还在,为什么线上出现 NoSuchMethodError?Lambda 与字符串拼接都出现 invokedynamic,是否意味着每次调用都生成新类?回答这些问题,需要看编译后的 class 文件:它记录了类型结构、方法指令,以及调用方期望找到的类和方法。
先建立基本模型:编译器把源码转换为 class 文件,JVM 加载并检查这些文件,再执行其中的方法。方法调用时使用的名称和类型信息已经写入调用方产物,运行时不会重新阅读源码来决定调用谁。本文先用四条加法指令说明执行模型,再展开文件结构、方法调用与二进制兼容问题。
1. 现象:同名源码不等于同一二进制契约
教学场景:调用方按旧版 SDK(软件开发工具包,此处指提供接口的依赖库)编译,运行时换成新版 SDK,某条路径抛出 NoSuchMethodError。这个错误表示运行时无法按调用方的引用找到所需方法。排查时先保存调用方和实际被加载的 SDK 产物;工作区最新源码不能证明线上加载了哪个版本。
方法引用包含所引用的类、方法名与描述符。描述符是方法参数和返回类型的编码,也是二进制调用契约的一部分。源码把返回值从 Object 改成 String,即使调用代码看起来没变,也可能改变方法的描述符;已经编译的调用方仍持有旧描述符。因此,重新编译后能通过的调用,不代表旧产物可以直接运行。解析是 JVM 根据符号引用查找目标的过程,能否找到目标还取决于类层次、加载器和访问规则,见 03。
2. 原理:ClassFile 是有索引的二进制结构
基础入口:先读一段最小字节码
字节码是 JVM 指令,不是某一种 CPU 的机器指令。每次方法调用的执行状态由栈帧承载:局部变量表保存参数和局部值,操作数栈暂存指令要处理的值。加载指令把值放到栈顶,运算指令取走输入并放回结果。
javap 是 JDK 自带的 class 查看工具,-c 展示方法指令,-s 展示描述符,-v 展示常量池、属性等详细信息。先不加 -v,避免第一次阅读就被大量结构淹没。
保存为 AddDemo.java:
java
public final class AddDemo {
public static int add(int left, int right) {
return left + right;
}
public static void main(String[] args) {
System.out.println(add(2, 3));
}
}在 JDK 8 或 17 环境下,执行 javac AddDemo.java、java AddDemo,预期输出为 5;再执行 javap -c -s AddDemo,add 方法的预期关键片段如下:
text
descriptor: (II)I
0: iload_0
1: iload_1
2: iadd
3: ireturn(II)I 表示两个 int 参数、int 返回值。slot(槽位)是局部变量表中的索引位置;静态方法没有 this,本例的两个参数分别位于 slot 0 和 1。调用 add(2, 3) 时,可以按下面的顺序理解操作数栈,右侧为栈顶:
| 指令 | 作用 | 执行后的操作数栈 |
|---|---|---|
iload_0 | 读取第一个参数 | [2] |
iload_1 | 读取第二个参数 | [2, 3] |
iadd | 取出两个整数,将和压栈 | [5] |
ireturn | 取出结果并返回给调用方 | 当前方法结束 |
左边的数字是字节码偏移,不是源码行号。这四条字节码也不意味着 CPU 最终执行四条机器指令:JIT(即时编译器)可以在运行时将代码编译为机器码并进一步优化。
读懂这段后,再按“文件骨架 → 常量池 → 方法描述符 → Code 属性 → 调用指令”的顺序展开。
2.1 文件骨架与版本号
text
magic → minor_version / major_version
→ constant_pool_count / constant_pool
→ access_flags / this_class / super_class / interfaces
→ fields → methods → attributesClassFile 是规范中对 class 文件结构的定义。它按顺序保存各部分数据,并通过索引连接相关条目。多字节整数按大端编码,即高位字节在前;u1/u2/u4 分别表示占 1、2、4 字节的无符号数。CAFEBABE 是文件开头的魔数,用于识别格式,不保证余下结构、引用或字节码合法。
| 文件部分 | 主要内容 | 与运行时的联系 |
|---|---|---|
| magic、minor/major version | 格式标识和产物版本 | JVM 先检查是否支持,不是改几个头部字节就能降级 |
| constant_pool_count、constant_pool | 常量池索引范围及变长条目 | 后续类名、字段名、描述符等通过索引引用 |
| access_flags | 当前类型的访问与种类标志 | 区分类、接口及相关属性,不是所有标志在所有位置通用 |
| this_class、super_class、interfaces | 当前类型、父类型与接口的常量池索引 | 加载和链接时建立类型关系;不是直接存放 Java Class 对象 |
| fields_count、fields | 字段标志、名称、描述符和属性 | 描述实例/静态字段,不存放每个实例的运行时字段值 |
| methods_count、methods | 方法标志、名称、描述符和属性 | 普通方法的指令在 Code 属性中,而不是方法项本身固定附带机器码 |
| attributes_count、attributes | 当前 class 的扩展属性 | 可包含源文件、签名、注解、引导方法等;字段/方法也有自己的属性表 |
读一个产物时先定位这些结构,再按索引追踪。无需入门就手工解析整份十六进制文件;如果要查看原始字节,应以实际编译器产物为准,不复制另一份 class 的固定偏移当通用布局。
| major | 目标版本 | 注意 |
|---|---|---|
| 52 | Java 8 | 旧 JVM 不能靠忽略版本加载新版指令/结构 |
| 55 | Java 11 | nestmates、动态常量等有各自版本边界 |
| 61 | Java 17 | 本篇默认 javac 17 实验 |
| 65 / 69 | Java 21 / 25 | 对应目标版本;下文产物实验仅覆盖 Java 8/17 |
preview(预览)特性是在特定版本中供试用、尚未作为稳定特性提供的能力。现代 preview class 的 minor 通常为 65535,运行时受同 major 与启用 preview 的约束;不能仅降低头部版本号把代码“转换”为旧版。javac --release 8 会约束平台 API 与 class 目标,比只设置 source/target 更完整,但仍不验证第三方依赖,见 10。
2.2 常量池不是字符串对象池
常量池是 class 文件中供其他结构按索引引用的条目集合。它保存字面量(如数值和字符串常量)、名称和类型编码,以及类、字段、方法的符号引用。符号引用用名称和类型描述目标,而不是直接记录运行时对象的内存地址。动态调用所需的引导信息也通过相关条目和属性组织。
CONSTANT_Utf8 是保存文本编码的条目,使用 modified UTF-8(JVM 使用的 UTF-8 变体),不能把其内容一律当作普通 UTF-8 字节串解码。
阅读时可以沿着引用关系追踪:CONSTANT_Class 通过索引找到类名文本;CONSTANT_Methodref 关联所引用的类和 CONSTANT_NameAndType,后者再关联方法名与描述符。因此,一条方法引用的信息分布在多个条目中,需要按索引组合起来理解。
索引 0 保留;constant_pool_count-1 是可用索引范围,不一定等于实际条目数:Long/Double 占两个索引位置,后一位置不可用。条目之间按索引引用,解析器不能把每项当固定长度。
类加载后,JVM 为其建立运行时常量池,供解析和执行使用,符号解析仍受加载器约束。字符串驻留则用于取得等值字符串的规范化引用:String.intern() 是相关 API,StringTable 是 HotSpot 的相关实现结构。它们与 class 文件中的文本条目不是同一结构,内存边界见 01。
2.3 描述符与 Signature 分工
| 表达 | 含义 |
|---|---|
B / C / S | byte / char / short |
I / J | int / long |
F / D / Z | float / double / boolean |
Ljava/lang/String; | 引用类型 |
[I / [[Ljava/lang/String; | 一维 int 数组 / 二维 String 数组 |
(IJ)D | int、long 参数,double 返回 |
()V | 无参数、void 返回;V 不能用于字段类型 |
字段描述符编码字段类型;方法描述符用括号内的部分编码参数,括号后的部分编码返回类型。例如 (IJ)D 中,I、J 是两个参数,D 是返回类型。
泛型声明与调用描述符承担不同职责。类型擦除是编译时将类型变量等转换为对应非泛型类型的处理,例如第 4 节未声明上界的 Mapper<T> 中,T 在调用描述符中对应 Object。Signature 属性保留泛型声明信息,供反射和工具读取,但不取消擦除,也不让 JVM 自动检查集合里的每个元素。
擦除后的接口方法与具体实现方法可能有不同描述符。编译器生成的桥接方法用于衔接这两个入口:先做必要的类型转换,再转发到具体实现。它是真实的 method_info(class 文件中的方法项),常带 ACC_BRIDGE、ACC_SYNTHETIC 标志,分别表示桥接方法和编译器生成的成员,不是单独一种属性。
2.4 Code、验证与调试信息
属性是附着在 class、字段、方法等结构上的命名信息块。方法的 Code 属性含 max_stack(操作数栈最大容量)、max_locals(局部变量表容量)、指令、异常处理表及子属性;抽象方法和 native 本地方法没有普通 Code 属性。这些容量按 JVM 的槽位单位计算,不能直接换算为机器栈字节数。
JVM 验证字节码时,需要检查跳转目标是否合法,以及指令所需的类型是否与局部变量表、操作数栈中的类型匹配。StackMapTable 描述部分程序点的验证类型状态,其中的 frame 是某个程序点的类型记录,不是运行中的完整调用栈。Agent(运行时代理工具)插桩是向字节码插入或改写指令;若改变控制流却留下不匹配的 frame,可能触发 VerifyError。
LineNumberTable 将字节码位置关联到源码行号,LocalVariableTable 提供局部变量调试信息。它们帮助工具展示源码视角,不是正确执行的必备结构,javac 调试开关会改变它们。
异常处理表定义受保护的指令区间、处理入口(handler)与捕获类型。控制流可能从正常执行路径转入异常处理入口,所以读同步块时,既要检查正常返回前释放锁,也要检查持锁期间发生异常时的释放路径;相关指令是 monitorexit。
| 常见属性 | 常见位置与用途 | 不要混淆为 |
|---|---|---|
| Code | 非 abstract/native 方法的字节码、容量与异常表 | 已经完成 JIT 的 CPU 机器码 |
| ConstantValue | 字段的适用常量值信息 | 所有 final 字段都无需初始化代码 |
| Signature | 类型、字段或方法的泛型声明等信息 | 自动恢复泛型运行时类型检查 |
| Exceptions | 方法声明的异常类型信息 | Code 中负责实际捕获的异常处理表 |
| SourceFile、LineNumberTable、LocalVariableTable | 对应层级的源文件和调试信息 | 正确运行必须具备的全部业务语义 |
| BootstrapMethods | class 级的动态引导信息 | 每次调用都重新运行全部引导逻辑 |
3. 实现:解析目标与选择接收者分别进行
普通方法调用需要区分两个问题:符号引用指向哪个方法,以及这次调用最终执行哪个实现。前者由解析处理;对于适用的实例调用,后者还要根据接收者的运行时类型选择。接收者就是调用表达式中承接方法调用的对象,例如 mapper.map(...) 中的 mapper 所引用的对象。分派指按调用规则选择实际执行方法的过程。
| 指令 | 契约与边界 |
|---|---|
| invokestatic | 静态调用,仍需运行时解析、访问检查与适用的初始化 |
| invokespecial | 构造器、父类调用及一些特殊调用;不是任意虚分派 |
| invokevirtual | 按引用与运行时接收者规则选择实例方法;可能被 JIT 去虚化 |
| invokeinterface | 接口调用,具体接收者和实现决定执行目标 |
| invokedynamic | 链接动态调用点,由 bootstrap 产生 CallSite,不按普通方法引用解析 |
重载是在同名方法之间按参数等条件选择,编译期根据静态类型等规则选定描述符;重写是子类型提供对应方法的实现,在适用调用中按接收者分派。因此,运行时选择重写实现,不等于重新进行源码层面的重载选择。
HotSpot 可使用虚方法表(vtable)、接口方法表(itable)和调用点缓存(inline cache)辅助选择目标。JIT 还可能根据已知类型把虚调用优化为直接调用,这称为去虚化。因此,“每次 invokevirtual 必查 vtable”不是规范要求,也不能描述所有执行阶段。
new 产生未初始化对象引用;dup 复制栈顶值;<init> 是构造器在 class 文件中的特殊名称。典型的 new; dup; invokespecial <init> 序列让构造调用消费一个引用,同时保留另一个给后续使用。引用在构造器调用前就已进入操作数栈,但验证规则限制未初始化引用的使用,详见 02。
4. 进阶选读:一份源码观察四条契约
第 2 节加法例子是基础练习。下面把泛型桥接、同步块、lambda 和字符串拼接放到一个产物中,用于进一步对照;可以一次只读其中一个方法,不需要在第一次学习字节码时理解全部动态调用点。
保存为 BytecodeDemo.java,可用 javac 8/17 编译:
java
import java.util.function.IntUnaryOperator;
public final class BytecodeDemo {
interface Mapper<T> {
T map(T value);
}
static final class StringMapper implements Mapper<String> {
public String map(String value) {
return value.toUpperCase(java.util.Locale.ROOT);
}
}
static final class Box {
final int value;
Box(int value) {
this.value = value;
}
}
static int locked(Object lock, int value) {
synchronized (lock) {
return value + 1;
}
}
static String label(int value) {
return "item-" + value;
}
public static void main(String[] args) {
IntUnaryOperator operation = value -> value + 1;
Box box = new Box(operation.applyAsInt(5));
Mapper<String> mapper = new StringMapper();
System.out.println("value=" + box.value);
System.out.println("label=" + label(box.value));
System.out.println("mapped=" + mapper.map("ok"));
System.out.println("locked=" + locked(box, box.value));
}
}bash
javac -g BytecodeDemo.java
java BytecodeDemo
javap -p -c -v BytecodeDemo.class
javap -p -c -v 'BytecodeDemo$StringMapper.class'-g 生成调试信息,javap -p 同时展示非公开成员。最后一行 shell 引号用于防止 $ 被展开,PowerShell 也可使用单引号。程序的预期输出为:
text
value=6
label=item-6
mapped=OK
locked=7- 沿
main的new Box看new/dup/invokespecial。Box构造器位于单独的BytecodeDemo$Box.class中,可用同样的javap选项查看其中的Object构造调用,以及写入字段的putfield指令。 - 找
Mapper.map的擦除描述符与checkcast(检查引用能否转换为目标类型);再找StringMapper的桥接方法,它从Object入口转换后转发到String方法。这解释了为什么源码只有一个实现方法,class 中却可能有两个方法入口。 - 找 Lambda 的
invokedynamic与BootstrapMethods中的LambdaMetafactory。这里观察的是动态调用点及其引导机制,不能据此断定每次都构造一个新的匿名类。 - 对
label比较 Java 8 的StringBuilder与 Java 17 的StringConcatFactory;对locked看获取监视器锁的monitorenter、正常与异常两条释放路径,以及异常处理表。
在独立输出目录比较,避免新旧编译覆盖同名 class:
bash
mkdir out8 out17
javac --release 8 -g -d out8 BytecodeDemo.java
javac -g -d out17 BytecodeDemo.java
javap -p -c -v out8/BytecodeDemo.class
javap -p -c -v out17/BytecodeDemo.class这组命令的 javac 必须为 17;真正的 javac 8 没有 --release。以实际产物和 build 为依据,不固定整个文件字节数、常量池编号或每段偏移。
5. invokedynamic、condy 与 nestmates 的边界
动态调用点是由 invokedynamic 表达的调用位置。与普通方法引用不同,它通过引导方法(bootstrap method)建立链接,得到 CallSite(调用点对象),再使用其中的目标执行调用。BootstrapMethods 属性记录所需的引导方法和静态参数。先理解“建立链接”和“执行已链接的调用”是不同阶段,再看以下边界:
- javac 的 Lambda 通常链接到
LambdaMetafactory,捕获值(lambda 使用的外部局部值)作为调用参数;实例是否复用不应成为业务中判断对象身份的依据。生成实现的细节依版本而异,例如可能使用不通过普通类名查找的隐藏类,仍可能产生类元数据。 - JDK 9 的 JEP 280 改变字符串拼接编译策略;源码写了
+不保证所有编译器、所有 target 或常量折叠场景都有动态调用。 - 动态调用点经链接后继续使用
CallSite;MutableCallSite、VolatileCallSite是允许目标变化的调用点类型,不能把“首次执行后永远固定”当通则。 - JDK 11 的
CONSTANT_Dynamic(常简称 condy)表示通过引导方法解析的动态常量,不是执行invokedynamic指令;它与动态调用共享 bootstrap 思路,但结构和结果约束不同。 - JDK 11 的 nestmates(同巢类型)机制允许同一巢中的类型直接进行私有成员访问,减少部分
access$合成访问器。这些访问器用于衔接私有访问,与解决擦除后方法入口差异的泛型桥接方法用途不同,所以 nestmates 不意味着桥接方法被废除;target 8 仍需旧访问策略。
6. 排障:检查实际产物而非猜源码
| 症状 | 检查 | 工程取舍 |
|---|---|---|
| UnsupportedClassVersionError | 失败类 major/minor、真正运行 java 的路径 | 统一工具链/--release;不要只改 class 头 |
| NoSuchMethodError / NoSuchFieldError | 调用方常量池的 owner/name/descriptor 与运行产物 | 对齐依赖版本;启动没走到路径不代表兼容 |
| VerifyError / ClassFormatError | 原始与插桩 class、版本、Code/frames/索引 | 升级兼容的生成器/Agent;不要关闭验证掩盖错误 |
| ClassCastException | checkcast 目标、桥接入口、代理或加载器身份 | 分清泛型误用、接口代理与同名异类 |
| BootstrapMethodError | bootstrap cause、依赖、访问/签名条件 | 找引导阶段根因,不直接归咎 Lambda 数量 |
javap 展示给它的文件,不自动证明正在运行的类来自该文件。部署包位置、加载来源与 loader 证据见 03;Spring 代理的应用边界见Spring 09,方法执行优化见 05。
实验结果与参考资料
实验环境:Windows x64 10.0.26200、i7-10700(16 逻辑 CPU),分别用 OpenJDK 17+35-2724 与 Oracle 1.8.0_191-b12 的 javac -g 编译并执行。两版均输出 value=6、label=item-6、mapped=OK、locked=7,退出码为 0。
两版 javap 均观察到 LambdaMetafactory、StringMapper 的 ACC_BRIDGE/checkcast,以及 locked 中一次 monitorenter、两处 monitorexit。17 产物 major=61,拼接使用 StringConcatFactory;8 产物 major=52,拼接使用 StringBuilder。
另用 javac 17 的 --release 8 编译到 out8,确认 major=52、StringBuilder 路径,并在 JVM 8 上执行通过;默认编译到 out17 则 major=61、StringConcatFactory。结果限于列明的编译器与 JVM,不覆盖 JDK 21/25、手工破坏字节码或真实 Agent 插桩;具体偏移需以实际产物为准。
名词解释
| 名词 | 本文中的含义 |
|---|---|
| class 文件 | 按 JVM 规定结构组织的二进制类型产物,不等于当前 CPU 的机器码。 |
| 常量池 | class 中的字面量、符号引用及相关条目集合,与字符串驻留表不同。 |
| 描述符(descriptor) | 编码字段类型或方法参数/返回类型的二进制契约。 |
| Signature | 保存泛型声明等信息的属性,不取消类型擦除。 |
| StackMapTable | 描述部分程序点的验证类型状态,不是运行中整个线程的栈快照。 |
| invokedynamic | 通过引导机制链接动态调用点的指令,不等于普通虚方法调用。 |