java 二进制兼容性_浅谈Java的二进制兼容(Binary Compatibility)

首先简单描述一下"二进制兼容"：假设有A和B两个项目，A依赖B，A基于v1版本的B源码编译出jar包之后，B的源代码发生了变化(v2)，如果A依赖v1版本编译的jar包可以和v2版本的B jar包共同工作，则我们称二者是二进制兼容的。以Hadoop为例，MapReduce社区关于MR1和MR2的二进制兼容性的工作目标就是让hadoop-1.x下编译的MapReduce程序可以直接在Yarn上运行

如何保证二进制兼容？下面从变量(field)，方法(method)和类(class)三个方面简单描述一下：

1. 变量：保证可见性不降低，即不要将变量定义从public修改为protected或者private

2. 方法：保证a) 可见性不降低; b) 参数和返回值类型不变; c) 不要从非抽象方法变为抽象方法

3. 类：保证a) 可见性不降低; b) 类型不变，不要从实现类变为接口或者抽象类;

如果是二进制不兼容导致的问题，表现会是什么样呢？最常见的是IncompatibleClassChangeError。以Hadoop为例，由于从branch-1(JobTracker/TaskTracker)到branch-2(Yarn)中影响二进制兼容性的改动主要是两部分：JobContext/TaskContext从类修改为接口(MAPREDUCE-954)，Counter从类修改为接口(MAPREDUCE-901)，因此我们在Yarn上运行MR1下编译的mapreduce程序时，会看到下述异常：

org.apache.hadoop.mapred.TaskTracker: Error running child : java.lang.IncompatibleClassChangeError: Found interface org.apache.hadoop.mapreduce.Counter, but class was expected

at org.apache.hadoop.hbase.mapreduce.TableRecordReaderImpl.updateCounters(TableRecordReaderImpl.java:272)此时我们使用javap -verbose TableRecordReaderImpl查看编译后class文件的符号链接，可以看到类似下述内容：

const #88 = class #293; // org/apache/hadoop/mapreduce/Counter可以验证异常信息：编译时的Counter是class，因此预期对象的类型应该是class(class was expected)，但是实际运行时Yarn的jar里Counter是interface(Found interface)

另外由二进制不兼容引起的异常还包括VerifyError、InstantiationException、IllegalAccessError等，遇到这些异常都可以考虑检查二进制是否兼容