上传AAB至Google Play后安装报错INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION

问题现象 #

• 应用在模拟器、实体设备本地测试运行完全正常
• 手动生成APK安装到手机无问题
• 本地将AAB转换为APK后安装也能正常运行
• 但AAB上传至Google Play后，多款设备从商店下载安装时均出现APK解析错误

已尝试操作 #

• 生成AAB前清理重建项目，甚至删除Android和node_modules文件夹重新操作，问题仍存在
• 检查AndroidManifest.xml配置未发现异常，配置内容如下：

<?xml version="1.0" encoding="utf-8" ?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity
            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|smallestScreenSize|screenLayout|uiMode"
            android:name=".MainActivity"
            android:label="@string/title_activity_main"
            android:theme="@style/AppTheme.NoActionBarLaunch"
            android:launchMode="singleTask"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <provider
            android:name="androidx.core.content.FileProvider"
            android:authorities="${applicationId}.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_paths" />
        </provider>
    </application>

    <!-- Permissions -->

    <uses-permission android:name="android.permission.INTERNET" />
</manifest>

项目配置文件 #

app/build.gradle #

apply plugin: 'com.android.application'

android {
    namespace "my.app.id"
    compileSdk rootProject.ext.compileSdkVersion
    defaultConfig {
        applicationId "my.app.id"
        minSdkVersion rootProject.ext.minSdkVersion
        targetSdkVersion rootProject.ext.targetSdkVersion
        versionCode 9
        versionName "1.1.0a"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
        aaptOptions {
             // Files and dirs to omit from the packaged assets dir, modified to accommodate modern web apps.
             // Default: https://android.googlesource.com/platform/frameworks/base/+/282e181b58cf72b6ca770dc7ca5f91f135444502/tools/aapt/AaptAssets.cpp#61
            ignoreAssetsPattern '!.svn:!.git:!.ds_store:!*.scc:.*:!CVS:!thumbs.db:!picasa.ini:!*~'
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

repositories {
    flatDir{
        dirs '../capacitor-cordova-android-plugins/src/main/libs', 'libs'
    }
}

dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
    implementation "androidx.coordinatorlayout:coordinatorlayout:$androidxCoordinatorLayoutVersion"
    implementation "androidx.core:core-splashscreen:$coreSplashScreenVersion"
    implementation project(':capacitor-android')
    testImplementation "junit:junit:$junitVersion"
    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
    implementation project(':capacitor-cordova-android-plugins')
}

apply from: 'capacitor.build.gradle'

try {
    def servicesJSON = file('google-services.json')
    if (servicesJSON.text) {
        apply plugin: 'com.google.gms.google-services'
    }
} catch(Exception e) {
    logger.info("google-services.json not found, google-services plugin not applied. Push Notifications won't work")
}

SDK版本配置 #

ext {
    minSdkVersion = 22
    compileSdkVersion = 34
    targetSdkVersion = 34
    androidxActivityVersion = '1.8.0'
    androidxAppCompatVersion = '1.6.1'
    androidxCoordinatorLayoutVersion = '1.2.0'
    androidxCoreVersion = '1.12.0'
    androidxFragmentVersion = '1.6.2'
    coreSplashScreenVersion = '1.0.1'
    androidxWebkitVersion = '1.9.0'
    junitVersion = '4.13.2'
    androidxJunitVersion = '1.1.5'
    androidxEspressoCoreVersion = '3.5.1'
    cordovaAndroidVersion = '10.1.1'
}

预启动报告错误截图 #

排查思路与解决方案 #

1. 检查Google Play签名兼容性 #

Google Play会对上传的AAB重新签名，可能存在签名配置冲突：

• 确认App Signing by Google Play使用的签名算法（如SHA-256）是否兼容minSdkVersion 22，低版本设备可能对某些签名版本支持有限；
• 本地生成AAB时，确保开启V2/V3签名，避免Google Play重新签名后出现签名版本不兼容问题。

2. 排查资源打包问题 #

• 检查所有资源文件（图片、布局、字符串等）的命名是否符合Android规范，禁止使用特殊字符、大写字母，Google Play的APK拆分逻辑可能对不规范命名的资源处理异常；
• 验证aaptOptions的ignoreAssetsPattern配置，确认没有遗漏需要排除的文件（如隐藏文件、版本控制文件），避免这些文件破坏APK结构。

3. 检查SDK与依赖兼容性 #

• 虽然compileSdk和targetSdk设置为34，但部分依赖库可能在低版本设备上存在兼容性问题，尝试将targetSdkVersion降级到33后重新生成AAB上传测试；
• 检查所有依赖库的版本，确保没有依赖仅支持高于minSdkVersion 22的SDK版本，必要时替换为兼容的旧版本依赖。

4. 验证FileProvider配置 #

• 确认res/xml/file_paths.xml文件存在且配置正确，检查路径规则是否覆盖了需要访问的文件目录；
• 验证${applicationId}是否在打包时正确替换为实际的应用ID，避免FileProvider的authorities配置无效导致解析错误。

5. 复现Play生成的APK问题 #

• 使用bundletool工具生成与Google Play一致的拆分APK，本地安装到出问题的设备上，复现错误后通过adb logcat过滤INSTALL_PARSE相关日志，获取更详细的错误信息；
• 利用Google Play内部测试渠道下载实际的拆分APK，安装后查看设备日志定位问题。

6. 调整版本号格式 #

版本名1.1.0a包含字母，部分设备的包解析器可能对非纯数字版本名不兼容，尝试将版本名改为纯数字格式（如1.1.0）后重新上传测试。

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