Android项目打包调试包失败：无法找到org.apache.commons.codec相关方法

我之前也碰到过一模一样的情况——Rebuild/Make的时候完全没报错，可一到打包APK或者用ADB真机运行就炸锅，提示找不到这个Base64类。下面是几个我亲测有效的解决思路，你可以一步步排查：

1. 先确认依赖是否正确引入 #

首先检查你模块级的build.gradle（也就是app/build.gradle）里，是不是真的把commons-codec的依赖加对了，版本也要选适配Android环境的稳定版，比如：

dependencies {
    implementation 'commons-codec:commons-codec:1.15'
}

加完记得点Sync Now同步依赖，有时候Gradle同步不彻底，就会出现"本地编译过了但打包找不到类"的奇葩问题。

2. 避开Android内置Base64的冲突坑 #

Android SDK本身自带了一个android.util.Base64类，如果你代码里直接写Base64，编译器可能默认帮你引用了系统的这个类，而不是你引入的commons-codec版本。解决办法很简单：

• 要么在代码里用全类名直接调用：

byte[] encodedData = org.apache.commons.codec.binary.Base64.encodeBase64("需要编码的内容".getBytes());

• 要么在导入包的时候明确指定：

import org.apache.commons.codec.binary.Base64;
// 别导入android.util.Base64！

3. 检查ProGuard/R8的混淆规则 #

如果你的项目开了混淆（哪怕是debug包，有些配置里也会默认开启基础混淆），ProGuard可能会把commons-codec的类误判为无用代码给移除了。这时候要在proguard-rules.pro里加一条保留规则：

-keep class org.apache.commons.codec.** { *; }
-keep interface org.apache.commons.codec.** { *; }

R8兼容大部分ProGuard规则，所以这条规则不管用哪个混淆工具都适用。

4. 清理Gradle缓存后重来 #

有时候Gradle的缓存会抽风，导致依赖没有正确加载到打包流程里。可以试试：

• 点击Android Studio顶部的File -> Invalidate Caches...，选择"Invalidate and Restart"重启IDE
• 手动删掉项目根目录下的.gradle文件夹，以及app/build文件夹，然后重新Sync和Build

5. 适配compileSdkVersion的版本 #

如果你的compileSdkVersion比较旧（比如28及以下），新版本的commons-codec可能用到了更高版本的Java特性，导致兼容问题。这种情况可以降级commons-codec的版本，比如用1.12版本：

implementation 'commons-codec:commons-codec:1.12'

建议先从检查依赖和全类名引用这两步开始试，这两个是最常见的触发原因。如果还是不行，再依次尝试后面的方案。

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