Flutter Android应用签名发布后无法安装问题求助

debug签名构建APK一切正常，但按照Flutter官方文档配置release签名（代码如下）后，应用无法在真机安装。已卸载旧debug版本，密钥和key.properties文件已生成，构建成功但弹出“应用未安装”提示，尝试flutter build apk --split-per-abi命令及构建App Bundle结果一致。

签名配置代码：

def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}

signingConfigs {
    release {
        keyAlias keystoreProperties['keyAlias']
        keyPassword keystoreProperties['keyPassword']
        storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
        storePassword keystoreProperties['storePassword']
    }
}

• 确认release构建已正确签名
  用命令验证APK签名状态：

  jarsigner -verify -verbose -certs app-release.apk
  

  如果输出显示“未签名”或签名异常，说明签名配置未生效，需检查：

  • key.properties中的storeFile路径是否正确：相对路径要基于Flutter项目根目录，比如密钥在项目外就写storeFile=../key.jks，也可以直接用绝对路径测试；
  • 确保buildTypes里的release配置引用了签名规则（很多人会漏这行）：

    buildTypes {
        release {
            signingConfig signingConfigs.release // 必须添加这行
            minifyEnabled true
            shrinkResources true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    

• 清理设备残留数据
  卸载debug版后可能仍有缓存或残留数据导致冲突：

  • 进入设备设置-应用管理，找到该应用（若还能看到），先清除数据再卸载；
  • 用adb命令彻底卸载：

    adb uninstall com.your.package.name
    

• 验证密钥有效性
  用命令查看密钥信息，确认密钥可用：

  keytool -list -v -keystore your-key.jks
  

  输入存储密码后，检查keyAlias是否存在、密钥密码是否正确。若密钥损坏，重新生成新密钥后再测试。

• 检查包名与签名冲突
  若设备上曾安装过同包名但不同签名的应用，会拒绝安装。确保当前release包的签名是全新的，或与已安装应用签名一致（如果是更新场景）。

• 检查AndroidManifest配置
  确认release版本的manifest中没有debug专属的权限或组件，同时检查android:installLocation设置，若设为internalOnly但设备内部存储不足，也会导致安装失败。

• 重新构建并检查输出
  执行以下命令清理并重新构建，查看终端输出是否有签名相关警告或错误：

  flutter clean
  flutter build apk --release
  

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