上传签名APK/App Bundle到Play开发者账户提示integrity check failed如何解决
该错误为APK Signature Scheme v2签名的完整性校验失败,本质是APK签名完成后内容被修改,导致实际分片SHA256摘要与签名时记录的预期值不匹配。
错误成因
- 签名后修改APK内容:签名完成后手动调整APK资源、二次打包、注入插件、错误执行zipalign操作,都会破坏签名后的APK完整性。
- 打包签名顺序错误:Android 7.0及以上引入v2签名后,zipalign对齐操作必须放在签名之前完成,签名后再执行对齐会直接导致校验失败;使用旧版jarsigner工具签名后再补v2签名也会触发该问题。
- 多渠道打包工具不兼容:部分旧版多渠道打包工具会直接修改APK的Manifest文件或内容区块,未适配v2签名的校验规则,修改后会破坏签名完整性。
- 签名配置冲突:同一个APK使用不同密钥重复签名,或者构建时v1、v2签名配置冲突,也会导致摘要不匹配。
解决方案
- 严格遵循标准打包签名流程:
- 构建Release版本未签名APK
- 执行zipalign对齐操作:
zipalign -v -p 4 app-unsigned.apk app-unsigned-aligned.apk - 使用官方apksigner工具执行签名,同时开启v1、v2签名适配全版本Android系统:
apksigner sign --ks your-keystore-path.jks --out app-release-signed.apk app-unsigned-aligned.apk - 签名完成后先本地校验签名有效性,确认无报错再上传:
apksigner verify app-release-signed.apk
- 适配v2签名的多渠道打包方案:如果需要生成多渠道包,优先使用Android Studio官方的productFlavor风味配置,或者使用支持直接写入v2签名区块的多渠道打包工具,禁止使用直接修改APK内容的旧版打包工具。
- 避免签名后修改APK:签名完成后除重命名外不要做任何修改APK内容的操作。
- 检查构建配置:确保build.gradle中release构建的签名配置同时开启v1、v2签名:
android { signingConfigs { release { keyAlias '你的密钥别名' keyPassword '你的密钥密码' storeFile file('你的密钥文件路径.jks') storePassword '你的密钥库密码' v1SigningEnabled true v2SigningEnabled true } } } - 使用Android Studio图形化打包时,在生成签名APK/Bundle的步骤中,签名版本同时勾选 V1 (Jar Signature) 和 V2 (Full APK Signature)。
内容的提问来源于stack exchange,提问作者fayssal el ansari
相关产品推荐
相关产品推荐

