You need to enable JavaScript to run this app. 上传签名APK/App Bundle到Play开发者账户提示integrity check failed如何解决
优惠活动
大模型
产品
解决方案
定价
更多

上传签名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签名配置冲突,也会导致摘要不匹配。

解决方案

  • 严格遵循标准打包签名流程:
    1. 构建Release版本未签名APK
    2. 执行zipalign对齐操作:
      zipalign -v -p 4 app-unsigned.apk app-unsigned-aligned.apk
      
    3. 使用官方apksigner工具执行签名,同时开启v1、v2签名适配全版本Android系统:
      apksigner sign --ks your-keystore-path.jks --out app-release-signed.apk app-unsigned-aligned.apk
      
    4. 签名完成后先本地校验签名有效性,确认无报错再上传:
      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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 05:54:04