开启minifyEnabled=true时DataStore Preferences致应用崩溃求助

问题分析 #

崩溃栈指向androidx.datastore.preferences.protobuf.UnsafeUtil类的初始化错误，说明混淆过程中破坏了Protobuf依赖库的反射逻辑。你当前仅添加了androidx.datastore包的保留规则，但DataStore内部依赖的Protobuf相关类也被混淆优化了，导致运行时无法通过反射调用必要方法。另外Debug模式下开启混淆不崩溃，大概率是因为Debug配置默认启用了更宽松的混淆规则（如禁用了部分优化或混淆），而Release模式的R8优化更激进。

解决方案 #

1. 补充ProGuard/R8规则

在你的混淆配置文件中添加以下规则，覆盖DataStore依赖的Protobuf相关类：

# 保留DataStore Preferences的Protobuf实现类
-keep class androidx.datastore.preferences.protobuf.** { *; }

# 保留Protobuf核心生成类及构造方法
-keep class com.google.protobuf.GeneratedMessageLite { *; }
-keepclassmembers class * extends com.google.protobuf.GeneratedMessageLite {
    <init>(...);
}

# 避免UnsafeUtil类被优化
-dontoptimize class androidx.datastore.preferences.protobuf.UnsafeUtil { *; }
-dontshrink class androidx.datastore.preferences.protobuf.UnsafeUtil { *; }

2. 升级DataStore版本

你使用的1.0.0版本是较早的稳定版，后续版本（如1.1.0及以上）修复了多个混淆相关的兼容性问题。修改依赖为：

implementation "androidx.datastore:datastore-preferences:1.1.0"
implementation "androidx.datastore:datastore-core:1.1.0"

3. 检查Release与Debug混淆配置差异

对比build.gradle中release和debug的混淆配置，确保Release模式没有额外启用导致类被过度优化的规则，例如：

• 确认Release模式没有单独设置-obfuscationdictionary或-classobfuscationdictionary等强混淆规则
• 检查是否在Release中启用了-allowaccessmodification但没有对应的保留规则

4. 验证混淆后的类结构

使用Android Studio的R8/ProGuard Mapping Viewer查看混淆后的UnsafeUtil类，确认arrayBaseOffset等方法没有被移除或重命名，确保Protobuf的反射逻辑能正常工作。

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