批量安装 APK 失败：
INSTALL_FAILED 错误码对照与处理

批量装 APK 失败时，最忌讳“全部重来”。先把完整错误码拿出来，再按类型处理；绝大多数错误与手机硬件无关。

先拿到完整错误

命令行执行：

adb install -r app.apk

或看群控任务的单台日志。只看到“安装失败”四个字，无法定位。重点看 Failure [INSTALL_FAILED_...] 后面的具体码。

第一类：空间与包状态

• INSTALL_FAILED_INSUFFICIENT_STORAGE：存储不足。清理缓存、卸载不用的应用，或换更大存储的设备。
• INSTALL_FAILED_ALREADY_EXISTS：同包名已安装。用 -r 覆盖，或先卸载。注意卸载会清数据。
• INSTALL_FAILED_VERSION_DOWNGRADE：要装的版本低于已安装版本。确认是否真的要降级，必要时先卸载；-d 可允许降级，但有数据风险。

第二类：签名与完整性

• INSTALL_FAILED_UPDATE_INCOMPATIBLE：新旧包签名不一致。常见于换了签名证书或从不同渠道下载的包。只能卸载旧包再装。
• INSTALL_PARSE_FAILED_NO_CERTIFICATES：APK 未签名或文件损坏。重新打包或重新下载，校验 SHA256。
• INSTALL_FAILED_INVALID_APK：包结构损坏、分包缺失或压缩方式异常。
• INSTALL_FAILED_VERIFICATION_FAILURE：系统安装校验未通过。检查包来源与签名，企业内测走正规签名流程，不建议长期关闭校验。

第三类：系统与厂商限制

• INSTALL_FAILED_USER_RESTRICTED：小米、红米等机型常见。开发者选项里关闭“USB 安装监控”，或允许“通过 USB 安装应用”。
• INSTALL_FAILED_TEST_ONLY：调试包带 testOnly 标记。用 -t 安装，或让开发重新出包。
• INSTALL_FAILED_INTERNAL_ERROR：系统服务异常。重启手机后再试，仍失败则抓 logcat。

第四类：包冲突

• INSTALL_FAILED_CONFLICTING_PROVIDER：两个应用声明了同一个 ContentProvider authority。换包名或卸载冲突应用。
• INSTALL_FAILED_DUPLICATE_PERMISSION：自定义权限重复。常见于同源多包共存，需要改权限名或使用不同签名。
• INSTALL_FAILED_SHARED_USER_INCOMPATIBLE：共享用户 ID 但签名不一致。

第五类：架构与版本

• INSTALL_FAILED_NO_MATCHING_ABIS：APK 不含设备 CPU 架构的 so 库。换 universal 包或对应 abi。
• INSTALL_FAILED_OLDER_SDK：APK 的 minSdkVersion 高于设备系统。
• INSTALL_FAILED_NEWER_SDK：APK 的 targetSdkVersion 低于系统要求，较少见，多见于极老应用。

批量前的五项预检

1. 剩余存储至少是 APK 体积的 2 倍；
2. 设备已解锁、未处于省电冻结；
3. 同包名是否已安装、签名是否一致；
4. APK 的 minSdk 与设备系统匹配；
5. 先装 1 台验证，再发整组。

失败之后只重试失败项

批量作业的价值在异常处理：每台设备、每个文件独立状态，失败项单独重试，不要把成功的设备再装一遍。诺程投屏的批量安装支持覆盖安装保留数据，失败结果按设备保留，具体流程见批量装 APK 与文件分发。

留证据

安装失败时同时保存：错误码、APK 的 SHA256、设备型号与系统版本、logcat 片段。下次遇到同类问题，能直接对照。采集方法见截图与 logcat 留痕。