Android10上”org.apache.commons.codec.binary.Hex ClassNotFoundException“解决及原因探究

在一次版本迭代后，突然在部分机型上爆出了一些崩溃，查看崩溃原因，原因内容是java.lang.NoClassDefFoundError：Failed resolution of: Lcom/apache/commons/desc/binary/Hex，具体如下图：

比较蛋疼的是在这次版本迭代后才出现这个问题，而且是高版本手机有问题，10.0的测试机有问题，6.0的测试却没问题。

问题定位及解决

基于上述不同机型的表现，用代码验证下，org.apache.commons.codec.binary.Hex这个类的加载情况，验证代码如下：

try {
    Class.forName("org.apache.commons.codec.binary.Hex");
    Log.e("HexTest","success");
} catch (ClassNotFoundException e) {
    e.printStackTrace();
    Log.e("HexTest","failed");
}

经过验证，在10.0的手机上输出的是falied，6.0的手机上输出的是success。

org.apache.commons.codec.binary.Hex这个类到底是干嘛的？是哪个包下的呢？
全局搜索项目代码，没发现org.apache.commons.codec.binary.Hex，这就表示这个类不是我们项目自己添加的依赖。

为了先解决问题，我就找到了相应的jar包，具体位于Apache Commons Codec，通过下面的方式给项目添加了依赖：

    compile group: 'commons-codec', name: 'commons-codec', version: '1.14'

问题暂时解决了。

问题原因分析

接下来我们来分析下出现这个问题的原因，问题的核心在于6.0的手机上是可以加载到这个类的，10.0的手机加载不到，初步猜测是手机系统内置了这个类，高版本的手机默认把这个类给hide了。

后来经过详细的排查本次迭代的代码，发现了一处可能的原因，就是编译版本compileSdkVersion从27升级到了28，然后把compileSdkVersion回退到27，这个问题果然没了。

api 28对应的是Android 9，具体对应关系请看Android version history。

emmmmmm，现在的问题是compileSdkVersion从27到28，跟这个apache的包hide起来有什么关系？

突然想起来Android6.0（也就是api 23）中移除了对Apache HTTP客户端的支持，这个也是apache包，他们之间是不是有什么关系呢？我们看下官网，它的解释是这样的：

Apache HTTP 客户端弃用
在 Android 6.0 中，我们移除了对 Apache HTTP 客户端的支持。从 Android 9 开始，该内容库已从 bootclasspath 中移除，且默认情况下应用无法使用它。

我们找一个org.apache.http.legacy的jar包分析一下，具体如下：

org.apache.http.legacy包下有我们想要的org.apache.commons.codec.binary.Hex类，那么我们可以参照官网提供的在高版本使用org.apache.http.legacy建议即可，具体参考Apache HTTP 客户端弃用。

我们只需要在AndroidManifest.xml中添加以下内容即可：

<uses-library
    android:name="org.apache.http.legacy"
    android:required="false" />

当然了，我们还可以用另一种方式，在模块的build.gradle中添加如下代码即可：

android { 
    useLibrary ‘org.apache.http.legacy'
}

需要说明的是，我们每个版本的Android sdk中其实都是有org.apache.http.legacy的jar包的，具体位于sdk/platforms/android-xx/options/路径下，如下图：

至此，出现问题的原因搞明白了，我们平时能引用到org.apache.commons.codec.binary.Hex类或者org.apache.commons.codec.binary.Base64这些类，是因为Android自带的org.apache.http.legacyjar包中包含了它们。如果你项目的compileSdkVersion是api 28及以上，那你就需要注意下这个问题了。

参考

Apache HTTP 客户端弃用