Android Studio调试密钥库变更致应用无法更新，如何保留SharedPreferences数据？

核心原因 #

报错本质是新旧应用签名不一致，Android要求更新应用必须与已安装版本使用相同签名。你电脑上的debug.keystore大概率被重新生成了——可能是误删除、清理.android目录、Android Studio版本切换触发自动重建等原因导致。

方案一：备份并恢复SharedPreferences数据 #

先导出数据，卸载重装后再导入，是最直接的保底方案：

1. 导出数据

   • 确保手机开启USB调试并连接电脑
   • 执行命令拉取SharedPreferences文件：

     # 将应用的shared_prefs文件复制到SD卡
     adb shell run-as com.your.package.name cp /data/data/com.your.package.name/shared_prefs/*.xml /sdcard/
     # 拉取到电脑本地目录
     adb pull /sdcard/*.xml ./sp_backup/
     

   替换com.your.package.name为你的应用包名，./sp_backup/可改为你指定的电脑本地备份路径。

2. 卸载旧应用并安装新版本
   直接卸载手机上的旧应用，正常安装新的debug版本。

3. 恢复数据

   • 将备份的xml文件推回手机：

     # 先推到SD卡
     adb push ./sp_backup/*.xml /sdcard/
     # 复制到应用的shared_prefs目录
     adb shell run-as com.your.package.name cp /sdcard/*.xml /data/data/com.your.package.name/shared_prefs/
     

   • 重启应用，数据即可恢复。

方案二：匹配旧应用签名，直接覆盖更新 #

让新apk使用和已安装应用相同的签名，就能直接覆盖更新，无需卸载：

1. 提取已安装应用的签名信息

   • 执行命令获取签名哈希：

     adb shell dumpsys package com.your.package.name | grep signatures
     

   • 若有旧版本apk安装包，也可用apksigner查看签名细节：

     apksigner verify --print-certs old_app.apk
     

2. 生成匹配签名的keystore

   • 使用keytool创建新keystore，输入与旧签名一致的密钥信息（默认debug签名的别名是androiddebugkey，密码为android）：

     keytool -genkeypair -v -keystore custom_debug.keystore -alias androiddebugkey -keyalg RSA -keysize 2048 -validity 10000
     

3. 配置Android Studio使用自定义签名
   在模块的build.gradle（或build.gradle.kts）中配置debug签名：

   android {
       signingConfigs {
           debug {
               storeFile file("custom_debug.keystore")
               storePassword "android"
               keyAlias "androiddebugkey"
               keyPassword "android"
           }
       }
       buildTypes {
           debug {
               signingConfig signingConfigs.debug
           }
       }
   }
   

   同步项目后，构建的debug apk即可用相同签名覆盖安装，数据完全保留。

方案三：尝试强制安装（仅部分场景有效） #

若报错是版本号或SDK兼容问题导致（而非签名完全不匹配），可尝试强制安装命令：

adb install -r -d new_app.apk

-r表示保留数据重装，-d允许降级安装，但如果是签名不一致，该命令大概率无效，仅作尝试。

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