安卓应用手动安装正常 Play商店安装报NullPointerException异常

• 混淆配置差异：本地测试和手动打包一般默认关闭minify混淆压缩，上架Google Play的release包通常开启混淆，R8/ProGuard的优化动作可能移除部分冗余空检查逻辑，同时混淆代码导致堆栈信息被加密。
• 核心空安全问题：报错信息中$this$toList是Kotlin集合扩展方法toList()的接收者参数，该参数Kotlin默认定义为非空类型，出现该报错说明业务代码中存在可空类型的集合对象（Iterable?/Array?/List?等）未做非空判断就直接调用toList()方法。本地测试场景下该对象始终有值不会触发崩溃，线上用户场景下该对象返回null时就会触发空指针异常。
• 场景关联：从崩溃堆栈可看到异常发生在LiveData的回调线程中，说明空集合大概率是LiveData返回的观测值，未做非空校验就直接执行了toList()操作。

• 复现问题对齐配置
  把debug构建的混淆配置和release版本对齐，本地直接复现线上崩溃，方便定位：

  buildTypes {
      debug {
          minifyEnabled true
          proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
          signingConfig signingConfigs.release
      }
      release {
          minifyEnabled true
          proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
      }
  }
  

• 定位具体崩溃代码
  如果上传Google Play时保留了mapping.txt映射文件，直接用Play后台的堆栈反解功能还原混淆后的类名方法名，定位到具体的toList()调用行；如果没有映射文件，全局搜索业务代码中所有toList()调用点，检查调用对象是否为可空类型。
• 修复空安全问题
  对所有可空集合的toList()调用增加空安全处理，推荐写法：

  // 安全调用+空值返回空列表，不影响后续逻辑
  val resultList = nullableCollection?.toList() ?: emptyList()
  

• 补充混淆规则
  在proguard-rules.pro中添加规则避免Kotlin集合相关逻辑被过度优化：

  -keep class kotlin.collections.** { *; }
  -keepclassmembers class kotlin.collections.** { *; }
  -dontwarn kotlin.collections.**
  

• 上线前校验
  开启混淆打包做全场景测试，确认崩溃问题完全修复后再重新提交Google Play。

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