从Kotlin迁移到Flutter后Play Store应用更新失败，求原因及解决方案

可能的原因及对应修复步骤 #

1. 签名配置不完整或不一致 #

尽管使用了同一个密钥库，但Flutter应用的签名可能未正确启用旧版依赖的签名版本（如V1签名），或签名参数与旧版存在差异。

• 修复：
  • 使用apksigner工具对比新旧APK的签名信息：

    apksigner verify --verbose /path/to/old.apk
    apksigner verify --verbose /path/to/new_flutter.apk
    

    确认两份输出中的证书指纹（SHA-1、SHA-256）、签名版本（V1/V2/V3）完全一致。
  • 检查Flutter项目的android/app/build.gradle签名配置，确保开启V1和V2签名，且密钥库信息与旧版完全匹配：

    signingConfigs {
        release {
            keyAlias '你的密钥别名'
            keyPassword '你的密钥密码'
            storeFile file('密钥库文件路径.jks')
            storePassword '密钥库密码'
            v1SigningEnabled true // 旧版应用可能依赖V1签名
            v2SigningEnabled true
        }
    }
    

    重新打包签名后上传测试。

2. AndroidManifest组件或权限冲突 #

新旧应用的Manifest配置存在不兼容项，比如组件导出属性、组件名称、权限声明差异，导致更新时安装校验失败。

• 修复：
  • 对比新旧应用的AndroidManifest.xml：
    • 确保主Activity的类名（如com.example.MainActivity）与旧版完全一致，不要随意更名。
    • 检查android:exported属性：Android 12+要求组件显式设置该属性，需确保旧版已有的组件（如Activity、Service）的exported值与新版一致，避免冲突。
    • 权限声明：新版权限需为旧版的超集，不要移除旧版已有的必要权限，新增权限需确保不会触发安装拦截。

3. 发布格式或版本代码问题 #

旧版为单体APK，新版使用App Bundle发布，可能导致Play Store生成的拆分APK与旧版单体APK存在更新兼容性问题；或版本代码未严格递增。

• 修复：
  • 尝试生成Flutter单体APK上传测试：

    flutter build apk --release
    

    上传该APK至Play Store，检查是否能正常更新。
  • 确认新版版本代码严格大于旧版的所有渠道版本代码（比如旧版版本代码为200，新版需≥201），避免版本覆盖逻辑错误。

4. Play Console发布状态异常 #

新版应用未完全发布到目标渠道，或处于审核/暂停状态，导致用户无法获取有效更新包。

• 修复：
  • 进入Play Console的「版本管理」→「应用版本」，确认新版状态为「已发布」，且覆盖了旧版的所有用户群体（如生产渠道、测试渠道）。
  • 若处于审核中，等待审核通过后再测试更新；若存在发布限制，排查并解除限制。

5. 设备端安装日志排查 #

Play Console的错误提示过于笼统，可通过设备日志获取具体失败原因。

• 修复：
  • 开启设备开发者选项中的「安装日志」，连接设备后执行：

    adb logcat | grep -i "install\|package"
    

    尝试更新应用，从日志中定位具体错误（如签名不匹配、组件冲突、权限拒绝等），针对性修复。

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