Android应用Debug混淆构建崩溃，混淆日志无法解析求助

咱们先来梳理下你的问题：你给处于SIT测试阶段的Android Debug包开启了混淆和资源压缩，APK体积减小符合预期，但服务调用时崩溃，且日志被混淆；加了-dontobfuscate就正常，但你不想完全关闭混淆，还不知道怎么用mapping.txt解析日志。

一、你的操作有没有问题？ #

给Debug构建开启minifyEnabled true和shrinkResources true本身没问题——很多团队会这么做来模拟Release包的体积和部分行为，方便提前发现混淆相关问题。但你的崩溃核心原因是ProGuard/R8的规则配置不完整，导致核心代码（比如网络请求的接口、数据模型、回调逻辑）被错误混淆，进而出现非空参数为null这类异常（日志里的IllegalArgumentException就是混淆后方法签名或参数匹配出了问题）。

二、解决崩溃问题（无需关闭混淆） #

你不需要用-dontobfuscate完全禁用混淆，只需要针对性添加ProGuard规则，避免核心代码被混淆：

1. 给第三方库添加适配规则 #

如果你用了Retrofit、Gson、Jetpack这类框架，必须保留它们的注解、接口或模型类，比如：

# Retrofit相关规则
-keep public interface retrofit2.Call
-keep class retrofit2.** { *; }
-keepattributes Signature
-keepattributes Exceptions

# Gson相关规则（如果用Gson解析接口返回）
-keep class com.yourpackage.model.** { *; } # 替换成你的数据模型包路径
-keepattributes *Annotation*
-keepclasseswithmembers class * {
    @com.google.gson.annotations.SerializedName <fields>;
}

# 保留NonNull等注解，避免参数校验逻辑失效
-keepattributes *Annotation*
-keepclasseswithmembers class * {
    @androidx.annotation.NonNull <methods>;
    @androidx.annotation.NonNull <fields>;
}

2. 优化Debug构建的混淆配置 #

可以改用R8（Android默认的代码压缩工具，比ProGuard更适配Android项目），同时保留调试所需的信息：
修改你的build.gradle的debug块：

buildTypes {
    debug {
        applicationIdSuffix ".debug"
        debuggable true
        shrinkResources true
        minifyEnabled true
        useProguard false // 改用R8
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        keepattributes *Annotation*,SourceFile,LineNumberTable // 保留注解、源文件名和行号，方便调试
    }
}

三、用mapping.txt解析混淆日志 #

Android Studio自带了便捷的日志还原工具，步骤如下：

1. 找到mapping.txt：它在你的项目目录app/build/outputs/mapping/debug/mapping.txt（因为是Debug构建，所以在debug子目录下）
2. 打开Android Studio，顶部菜单栏选择Build > Analyze APK...，选中你崩溃的那个Debug APK
3. 在APK Analyzer窗口右上角，点击ProGuard Mapping按钮，加载你的mapping.txt文件
4. 把混淆后的崩溃日志复制到输入框，点击Deobfuscate，就能得到还原后的清晰日志——你能直接看到哪个类、哪个方法抛出了异常，针对性添加Keep规则就好。

另外也可以用命令行工具：找到Android SDK目录下的tools/proguard/bin/proguardgui.bat（Windows）或proguardgui.sh（Mac/Linux），打开后选择ReTrace选项卡，加载mapping.txt并粘贴混淆日志，点击ReTrace即可得到还原日志。

总结 #

你的操作本身没有错误，只是Debug混淆需要更细致的规则配置。先还原日志找到具体出错的代码，再针对性添加Keep规则，就能在保留混淆压缩的同时避免崩溃。

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