PMS 排障：安装失败与包管理问题检查链

前八章把包的一生讲完了。这一章把它们串成排障链：安装失败、包找不到、权限异常、 数据目录异常，按什么顺序查、看什么证据。

先保留 pm install 的完整错误码和 PackageInstaller 日志，再检查解析结果、签名、权限、 目录与启用状态。当前 dumpsys package 快照不能代替安装事务发生时的过程证据。

先确定失败发生在哪个阶段

常见误解	正确理解
安装失败都是 APK 问题	可能是签名、权限、存储、版本、系统限制任一一环
dumpsys package 就是全部证据	它只给当前状态，安装过程证据要看日志与错误码
“找不到应用”就是没装	可能是解析失败、被禁用、被隐藏或卸载残留

核心结论

1. 排障顺序固定：安装错误码 → 包表与解析 → 签名/权限 → 数据目录 → 状态与广播。
2. pm install 错误码直接指向阶段：PARSE 指向解析，UPDATE_INCOMPATIBLE 指向签名， INSUFFICIENT_STORAGE 指向存储。
3. dumpsys package 看解析结果与授予状态；logcat 看安装会话流转。
4. “包找不到”先确认包表有没有、状态是否 enabled、是否被隐藏。
5. 修复后要复现验证：卸载重装、更新、清除数据三个场景都要回归。

五步检查链

逐步解释：

1. 错误码：先看 pm install 输出与 logcat，确定失败阶段。
2. 包表：dumpsys package 确认包是否被解析、组件是否齐全。
3. 签名与权限：对照证书与权限定义，确认校验是否通过。
4. 数据目录：检查 /data/app 与用户数据目录是否异常。
5. 状态与广播：确认 enabled/disabled、版本与事件广播是否正常。

常用命令与证据

环境：开发设备或模拟器；查看 /data 需要 root。

adb shell pm install -r /data/local/tmp/app.apk
adb shell dumpsys package <包名>
adb shell pm list packages | grep <关键字>
adb shell pm path <包名>
adb shell su 0 ls -l /data/app/ | grep <包名>
adb logcat -v threadtime | grep -E "PackageInstaller|PackageManager|installd"

证据	含义	下一步
INSTALL_PARSE_FAILED_*	Manifest 解析失败	用 aapt/apksigner 检查 APK
INSTALL_FAILED_UPDATE_INCOMPATIBLE	新旧签名不一致	对照证书
INSTALL_FAILED_INSUFFICIENT_STORAGE	存储不足	清理 /data/app 与用户分区
包表里没有包	解析或扫描失败	回看扫描日志
enabled=false	被禁用	确认禁用来源
数据目录缺失	清除数据或卸载残留	重装或恢复数据

常见场景与定位思路

场景一：安装直接失败

先读错误码：PARSE 类检查 APK 完整性；UPDATE_INCOMPATIBLE 对照签名；VERSION_DOWNGRADE 检查版本号；NO_MATCHING_ABIS 检查 ABI。不要跳过错误码直接重试。

场景二：装上了但桌面没图标

确认是否被禁用/隐藏、launcher 是否收到 ADDED 广播、组件表里有没有 MAIN/LAUNCHER。 “装上了但找不到”多数是组件或状态问题，不是安装问题。

场景三：权限弹窗不对或调用被拒

用 dumpsys package 看权限授予，用 pm grant/revoke 对照；再确认 AppOps 与角色。 权限检查是多层叠加，先看授予状态再看策略。

场景四：清除数据/卸载后异常

确认清除数据只删了用户数据，卸载删了包目录；检查残留目录是否导致“重装失败”，必要时 用 pm uninstall -k 的逆操作核对数据保留范围。

常见误区

1. “错误码能直接告诉根因”：错误码指向阶段，根因要结合日志与状态确认。
2. “dumpsys package 是安装日志”：它是当前状态快照。
3. “禁用 = 卸载”：状态不同，排查入口不同。
4. “重装前不清理也能复现”：残留状态会影响复现，先清理再验证。

延伸问题

1. installd 在安装流程中承担什么职责，失败如何排查？
2. 如何用 apkanalyzer 离线排查 Manifest 与签名？
3. 多用户下安装失败与单用户有什么差异？
4. 如何设计包管理问题的自动化回归用例？

源码入口

文件	关键位置	作用
PackageManagerService.java	安装/删除入口	包表维护
PackageInstallerService.java	会话状态	安装流程
PermissionManagerService.java	检查入口	权限判定
PackageManagerShellCommand.java	pm 命令	命令行排查

公共路径沿用本系列各章：frameworks/base/services/core/java/com/android/server/pm/。 行号以 r75 检索为准。

包状态最终如何参与组件启动，见 AMS 与应用进程。