title: ApplicationExitInfo 与版本化线上诊断 chapter: '26.6' section: '26.6' status: finalized applicable_versions: Android 5 (API 21) - Android 17 (API 37) last_verified: '2026-08-15' last_source_verified_at: '2026-08-15' last_verified_against: Current Android Developers ApplicationExitInfo/AnrInfo/ActivityManager docs, AOSP android-17.0.0_r1 ApplicationExitInfo/AppExitInfoTracker/config/tombstone sources, and KOOM upstream retrieved 2026-08-15 confidence: high pipeline_stage: ready-to-publish task6_state: reviewed task9_state: reviewed task2b_state: fixed sources:

• type: research path: 2026-05-08-applicationexitinfo-android11-below-alternatives.md
• type: research path: 2026-05-09-application-exit-info-android11-alternatives.md
• type: legacy-reference-preserved path: Clippings/线上疑难问题该如何排查和跟踪？-Android开发高手课-极客时间 2.md
• type: legacy-reference-preserved path: Clippings/线上疑难问题该如何排查和跟踪？-Android开发高手课-极客时间 3.md
• type: legacy-reference-preserved path: Clippings/线上疑难问题该如何排查和跟踪？-Android开发高手课-极客时间 7.md
• type: legacy-reference-preserved path: Clippings/线上疑难问题该如何排查和跟踪？-Android开发高手课-极客时间 8.md
• type: official path: https://developer.android.com/reference/android/app/ApplicationExitInfo
• type: official path: https://developer.android.com/reference/android/app/ActivityManager#getHistoricalProcessExitReasons(java.lang.String,int,int)
• type: official path: https://developer.android.com/topic/performance/vitals/anr
• type: official path: https://developer.android.com/ndk/guides/debug
• type: aosp path: https://android.googlesource.com/platform/frameworks/base/+/android-17.0.0_r1/core/java/android/app/ApplicationExitInfo.java
• type: aosp path: https://android.googlesource.com/platform/frameworks/base/+/android-17.0.0_r1/core/java/android/app/ActivityManager.java
• type: aosp path: https://android.googlesource.com/platform/frameworks/base/+/android-17.0.0_r1/services/core/java/com/android/server/am/AppExitInfoTracker.java
• type: aosp path: https://android.googlesource.com/platform/frameworks/base/+/android-17.0.0_r1/services/core/java/com/android/server/os/NativeTombstoneManager.java
• type: aosp path: https://android.googlesource.com/platform/system/core/+/android-17.0.0_r1/debuggerd/proto/tombstone.proto
• type: official path: https://developer.android.com/reference/android/app/ApplicationExitInfo.AnrInfo
• type: aosp path: https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/res/res/values/config.xml
• type: source path: https://github.com/KwaiAppTeam/KOOM
• type: legacy-reference-preserved path: packages/modules/Profiling/framework/java/android/os/ProfilingResult.java
• type: aosp path: https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/app/ApplicationExitInfo.java
• type: aosp path: https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/app/ActivityManager.java
• type: aosp path: https://android.googlesource.com/platform/packages/modules/Profiling/+/refs/tags/android-17.0.0_r1/framework/java/android/os/ProfilingManager.java
• type: aosp path: https://android.googlesource.com/platform/packages/modules/Profiling/+/refs/tags/android-17.0.0_r1/framework/java/android/os/ProfilingResult.java
• type: aosp path: https://android.googlesource.com/platform/packages/modules/Profiling/+/refs/tags/android-17.0.0_r1/framework/java/android/os/ProfilingTrigger.java
• type: official path: https://developer.android.com/reference/android/os/ProfilingManager
• type: official path: https://developer.android.com/reference/android/os/ProfilingResult
• type: official path: https://developer.android.com/reference/android/os/ProfilingTrigger
• type: official path: https://developer.android.com/topic/performance/tracing/profiling-manager/how-to-capture
• type: official path: https://developer.android.com/topic/performance/tracing/profiling-manager/trigger-based-capture
• type: official path: https://developer.android.com/topic/performance/tracing/profiling-manager/will-my-profile-always-be-collected
• type: official path: https://developer.android.com/about/versions/17/behavior-changes-all
• type: official path: https://developer.android.com/about/versions/17/features
• type: official path: https://developer.android.com/reference/android/os/Build.VERSION
• type: official path: https://developer.android.com/reference/android/os/Build.VERSION_CODES_FULL
• type: legacy-reference-preserved path: packages/modules/Profiling tags:
• applicationexitinfo
• observability
• crash
• anr
• oom
• lmk
• online-diagnostics
• application-exit-info
• profiling-manager related_chapters:
• '15.10'
• '17.8'
• '20.2'
• '20.3'
• '20.4'
• '20.5'
• '26.2'
• '26.3'
• '15.7'
• '14.1'
• '16.3' last_draft_polish_at: '2026-08-15T20:01:08+08:00' last_draft_polish_run_id: 20260815-200108-gracker-writing-469 last_review_finalize_at: '2026-08-15T20:01:08+08:00' last_review_finalize_run_id: 20260815-200108-gracker-writing-469 last_rework_at: '2026-08-15T20:01:08+08:00' last_rework_run_id: 20260815-200108-gracker-writing-469 last_consolidated_at: '2026-08-24' consolidated_from:
• src/part5-app/ch26-observability/08-application-exit-info.md
• src/part5-app/ch26-observability/10-versioned-diagnostics.md

ApplicationExitInfo 与版本化线上诊断

ApplicationExitInfo 是 Android 保存的近期进程退出记录，提供系统对退出事件的分类与现场信息。进程可能来不及执行崩溃采集 SDK 的回调，Android 仍可保存退出原因（reason）、退出状态（status）、进程重要性（importance）、时间、最近一次内存采样和部分跟踪记录（trace）。Android 11 / API 30 起，应用可以在新进程启动后查询这些记录，用于分类崩溃、应用无响应（ANR）、低内存终止、用户操作和包状态变化。

本文核对的源码来自 Android 开放源代码项目（AOSP）的 Android 17 / API 37 / android-17.0.0_r1 标签。相关内容集中在 Android 框架和应用接口，不涉及某个 Linux 内核版本特有的机制，所以无需记录内核标签（kernel tag）。ApplicationExitInfo 的历史容量有限，字段也可能缺失。它需要与崩溃采集 SDK、ANR 监控和原生代码符号化（把程序地址还原为函数或源码位置）配合使用，单独一条退出记录无法证明某段业务代码就是退出原因。

ApplicationExitInfo 提供历史进程退出原因、状态和部分诊断数据；ProfilingManager 与 ProfilingTrigger 在较新版本提供受控性能采集。能力随 API、flag、系统实现和用户设置变化。

退出原因、状态、Trace 与访问范围

进程退出归因的观测目标

Java 崩溃处理器记录未捕获异常，原生崩溃 SDK 记录操作系统信号（signal）和自身生成的现场，ANR 监控记录主线程状态与系统超时。ApplicationExitInfo 在进程结束后补充系统记录。服务端要保存各来源的原始事件，再依据进程、时间、构建和现场特征归并；直接相加会把同一次故障重复计数。

一条退出记录至少要回答六个问题：

package UID 是安装包被分配的 UID；real UID 是进程实际运行时使用的内核 UID，隔离进程中两者可能不同；defining UID 在外部服务使用应用 Zygote（预先加载运行环境并派生应用进程的模板进程）时标识服务提供方。普通单进程应用里这些值常常相同，多进程和外部服务场景仍要分别保留。

公开 ApplicationExitInfo 没有 getSubReason()。AOSP 服务内部的细分原因（subreason）不属于第三方应用可读取的 SDK 合约，也不应成为普通应用数据结构（schema）的必填字段。description 只供人阅读，系统不保证它在不同设备或版本上的格式稳定，服务端不能依靠解析字符串恢复内部 subreason。

退出归因还要区分事件分类与产品严重度。REASON_CRASH、REASON_CRASH_NATIVE 和 REASON_ANR 通常可直接进入内部稳定性事件流；REASON_LOW_MEMORY 要结合 importance 和场景判断；用户、包更新、权限与多用户状态变化通常作为时间线背景。计算指标前必须跨来源去重，并明确分子、分母和“用户可感知”的定义。

API 30+ 的 ApplicationExitInfo

Android 11 引入 ActivityManager.getHistoricalProcessExitReasons(packageName, pid, maxNum)。结果按时间从新到旧排列：

• packageName = null 匹配调用者 UID 下的包；查询其他 UID 的包需要系统级 DUMP 权限，普通第三方应用不能依赖这种能力。
• pid = 0 表示不按进程 ID（PID）过滤。PID 会被系统复用，不能单独作为跨进程启动周期的事件 ID。
• maxNum = 0 表示返回当前仍保留的全部匹配记录，历史范围仍受系统容量限制。
• 通过 BIND_EXTERNAL_SERVICE 绑定的外部服务进程也可能出现在调用包的退出记录中，归因时要保留进程名与 UID 字段。

公开文档只承诺历史信息位于环形缓冲区（ring buffer，容量满后会淘汰旧记录）。AOSP android-17.0.0_r1 的默认资源 config_app_exit_info_history_list_size 是每包 16 条，但设备厂商可以覆盖这个资源值，它不属于 SDK 合约。Android 17 的 AppExitInfoContainer 使用 ArrayList<ApplicationExitInfo>，容量超限时删除时间最早的记录；同一 PID 可以保留多次退出。因此，基于旧实现得出的“以 PID 为键，同一 PID 必然覆盖”不适用于该标签。

这段代码只读取轻量元数据，不在调用线程复制 trace。调用应放到应用自己的 I/O 执行器（executor）中；maxNum = 0 读取系统当前保留的记录，服务端或本地处理游标（记录已处理位置）负责去重。

@RequiresApi(Build.VERSION_CODES.R)
fun readExitSummaries(
    context: Context,
    maxNum: Int = 0
): List<ExitSummary> {
    require(maxNum >= 0)

    val activityManager = context.getSystemService(ActivityManager::class.java)
    val records = activityManager.getHistoricalProcessExitReasons(
        context.packageName,
        0,
        maxNum
    )

    return records.map { info ->
        val anrInfo = if (Build.VERSION.SDK_INT >= 37) info.anrInfo else null
        ExitSummary(
            processName = info.processName,
            pid = info.pid,
            reason = info.reason,
            status = info.status,
            importance = info.importance,
            timestampMs = info.timestamp,
            pssKb = info.pss,
            rssKb = info.rss,
            description = info.description,
            processStateSummary = info.processStateSummary,
            anrId = anrInfo?.anrId,
            anrType = anrInfo?.anrType,
            anrTimeoutMs = anrInfo?.timeoutMillis,
            anrUserPerceptible = anrInfo?.isUserPerceptible
        )
    }
}

ExitSummary 是项目自定义的数据传输对象（DTO），只负责在层之间传递退出摘要。description 只能用于受控明细，不能参与稳定分组；processStateSummary 与 ANR 字段都可能为 null。查询会通过 Binder 进行进程间通信，批量返回的对象也会占用内存，所以不能在首帧关键路径同步执行。

reason 是分类主字段，status 的解释取决于 reason：进程调用 exit() 时，它保存退出码；进程因操作系统信号结束时，它保存信号编号。业务协议应保存 SDK 枚举值与采集设备的 API 级别，不要自行复制 reason 的整数常量。

部分设备不支持低内存终止（LMK）分类上报，应先调用 ActivityManager.isLowMemoryKillReportSupported()。在不支持的设备上，内存压力终止可能表现为 REASON_SIGNALED，且 status 为 SIGKILL。即使设备支持，REASON_LOW_MEMORY 也只说明系统当时存在内存压力，无法单独证明应用存在内存泄漏。

importance 记录进程死亡前的系统重要性级别，可以区分前台、前台服务、可见、服务、缓存等进程状态，但不能恢复具体页面。应用仍要保存最近场景、最近一次 Activity 恢复（resume）、首帧是否完成和升级迁移状态。

PSS/RSS 是系统最近一次采样，进程在采样前死亡时可能为 0。服务端应把 0 标记为“不可用”，不能插值，也不能视为进程死亡时刻的精确内存。timestamp 来自可被校时调整的墙上时钟（wall clock）；应用性能事件常用只向前递增的单调时钟（elapsed time）。关联两类时间戳时，要使用应用记录的 wall/elapsed 校准点，不能直接相减。

ActivityManager.setProcessStateSummary() 可保存最多 128 字节的应用状态，系统可能限制高频调用并抛出 RuntimeException。这里适合保存不含个人数据的场景码、实验或配置版本和短状态位，不适合恢复界面，也不能保存账号、令牌或自由文本。只在状态变化时更新，并把服务端实验分组记录（assignment）作为实验归属的权威来源。

ANR 与原生崩溃的现场关联

getTraceInputStream() 从 API 30 开始存在，常见内容是系统 ANR 跟踪记录。Android 12 / API 31 起，reason 为 REASON_CRASH_NATIVE 时可返回符合 AOSP tombstone.proto 的 Protocol Buffers（protobuf，一种二进制结构化数据格式）。ANR 文本与 tombstone protobuf 的格式不同，不能根据文件扩展名或“流非空”统一按文本解析。

trace 还有三个容易误判的边界：

• trace 保存在独立的系统级环形缓冲区，可能被包括其他应用在内的新记录覆盖，因此返回 null 属于允许的结果。
• 应用发生 ANR 后恢复，又因其他原因退出时，之前的 ANR trace 可能附在后一次退出记录上。实际退出原因与附件类型必须分别保存。
• 读取流会发生输入/输出（I/O）操作；应用应在后台按字节上限复制到私有临时文件，校验写入成功后再发布为待上传附件。超过配额、解析失败和缺失都要作为明确状态上报。

ANR 事件可以按以下证据关联：

1. 应用轻量监控记录主线程停顿、页面、操作，以及同一单调时钟上的 I/O 和网络摘要。
2. 后续进程读取历史退出记录，保留 reason、进程名、timestamp、importance 和 trace 是否存在。
3. 服务端在允许的时间误差内，用进程、构建、场景和堆栈特征寻找同一事件的候选来源；无法唯一匹配时保留多条事件，不强行合并。
4. 取得系统 trace 后再分析锁等待、Binder、I/O、调度、垃圾回收（GC）与消息执行。一次采样堆栈不能独立证明根因。

Android 17 / API 37 的 getAnrInfo() 还提供 ANR ID、类型、系统等待的超时时长和 isUserPerceptible()。其中 isUserPerceptible() 表示系统是否向用户显示了 ANR 对话框。AnrInfo 只在 reason 为 REASON_ANR 时才可能存在；旧版本不能通过解析 description 构造等价字段。ANR ID 只保证在同一种 ANR 类型内唯一，跨类型或跨数据源去重仍要带上类型、进程和时间。

API 37 还增加 ActivityManager.registerAnrWarningListener()。它会在应用接近 ANR 超时时尽力回调，执行回调的 executor 不应使用主线程。该回调可能不执行，也可能没有足够时间完成工作，只适合写入已经预分配的轻量摘要或触发受控采集，不能作为 ANR 覆盖率保证。

原生崩溃事件可以把 Crashpad、Breakpad 或自研 SDK 生成的小型转储（minidump）及事件封装（envelope），与 REASON_CRASH_NATIVE 对应的 tombstone 作为独立原始来源。服务端用构建 ID、应用二进制接口（ABI）、操作系统信号、故障地址（fault address）、崩溃线程和符号化后的栈顶帧匹配候选。SDK 现场缺失时，tombstone 可以补充证据；tombstone 缺失时也要保留 SDK 事件，不能因为某个附件不存在而删除事故记录。

Play Console、Crashlytics 与自研应用性能监控（APM）各有不同的安装来源、采样、去重和用户口径，ApplicationExitInfo 则保存系统的近期进程记录。同一次崩溃或 ANR 可能出现在多个来源，统一报表必须先归并事件，并保留来源事件 ID 列表（source_event_ids）与归并置信度。

Android 11 以下的替代路径

API 29 及以下没有公开的历史退出原因 API。应用可以保存退出前状态并在下次启动生成“异常退出候选”，但无法可靠区分 SIGKILL、低内存终止、系统重启、厂商进程管理和用户移除任务。

低版本可用路径如下：

低版本方案依赖提前保存的轻量状态。应用启动时写入带设备启动周期和应用会话标识的 launch_started，业务达到可用状态后写入 launch_finished；Java 崩溃处理器只追加最小 crash_pending。下次启动发现未完成标记时，先生成“上次进程未完成启动”的候选，再结合设备是否重启、应用是否升级、最近前后台状态与内存摘要分类。

系统或应用崩溃可能发生在标记落盘中途，状态文件需要原子替换、版本号和校验。标记还会受清除数据、备份恢复和时钟变化影响，不能把一次残留标记直接计为 LMK。

开源内存监控库 KOOM 采用的一类 fork-dump（派生子进程执行转储）方案会暂停 Android Runtime（ART），通过 fork 创建子进程，再由子进程生成 HPROF。它依赖 ART 私有符号、动态链接和特定版本兼容代码，不属于 Android SDK 能力。若项目采用此类方案，应把支持版本、厂商系统（ROM）验证、失败回退、隐私、磁盘峰值和停用开关作为准入条件；Android 17 的正式发布构建不能因为兼容旧版本而默认启用私有 ART 依赖。

API 30+ 仍可保留轻量状态机，用来提供业务场景和发现系统记录缺失，但 reason 以公开系统字段为主。低版本状态机只能输出带置信度的候选类别。

低版本证据等级与统一事件模型

Android 5–10 的退出推断必须把结论、置信度和原始证据分开保存。一个未闭合的会话标记只说明上次进程没有完成预期写入，不能区分 SIGKILL、LMK、设备重启、用户停止、包更新或写盘失败。建议使用下面的证据等级：

统一数据域中，system_reason_code 只接收 API 30+ ApplicationExitInfo 的公开 reason；legacy_reason 只接收应用规则结论；reason_source 区分 android_system、external_platform、app_confirmed 和 app_inferred。两类原因不能用 coalesce()（返回第一个非空值的数据库函数）合成一个字段，否则会丢失证据来源。事件还应保留 session_id、process_name、设备启动周期、前一进程启动的单调时间、发现旧会话的时间、confidence、原始证据数组 evidence[]、附件引用、采集器与规则版本。

低版本没有可靠退出时间，下一次启动时间只表示何时发现旧会话未闭合。PID 也会复用；关联时应使用会话、进程、构建、设备启动周期和证据指纹（evidence fingerprint，由多项稳定特征生成的匹配键）。外部 ANR 或崩溃记录无法唯一匹配时，保留候选及分数，不要为了生成一个统一事件而丢掉来源关系。

调试环境中的 /data/anr/、系统事件日志、dumpsys（导出系统服务状态的诊断命令）和 LMKD 记录可以补充证据，但普通发布包不能把它们当成稳定的生产接口。KOOM 一类 fork-dump 方案只能在进程仍有执行机会时保存 Java 堆现场，并依赖 ART 私有实现；这类记录可以进入 evidence[]，但不能把疑似内存压力升级为系统确认。所有 minidump、HPROF、内存映射（maps）、线程栈和日志附件都要分别控制采样、存储、加密、访问和删除。

端侧存储与上报设计

退出历史容量有限，应用需要在后续活跃进程中及时查询，但查询和附件 I/O 不应进入首帧关键路径。可以在应用可交互后由后台 executor 读取轻量元数据，再由受系统调度约束的任务处理 trace 与上传。

流程图把元数据与大附件分开处理。trace 复制失败不会阻止退出摘要进入队列；上传成功后仍保留来源键（key），避免下一次启动重复计数。图中的 upsert 表示“来源指纹已存在则更新，不存在则插入”。

flowchart TD
  A[应用完成首帧关键工作] --> B[后台查询退出历史]
  B --> C[按来源指纹 upsert 摘要]
  C --> D[摘要进入本地发送队列]
  C --> E[符合策略时读取 trace]
  E --> F[字节上限、格式和隐私检查]
  F --> G[原子写入附件并关联摘要]
  D --> H[上传摘要]
  G --> I[按约束上传附件]
  H --> J[服务端跨来源归并]
  I --> J

系统稍后可能为已有记录补上 ANR trace，因此这里需要 upsert。若本地只保存“已看过 timestamp”并永久跳过该记录，就可能漏掉后来出现的附件。

ExitEnvelope 是项目自定义的退出事件封装，可以使用以下公开字段：

source_fingerprint 只标识同一采集来源中的记录，不能充当跨来源统一事件 ID。崩溃 SDK 与系统退出记录的时间精度、进程标识和到达顺序不同，服务端应输出“确定匹配、候选匹配、未匹配”，不要在端侧提前合并并丢失原始关系。

隐私要求优先于字段完整度。ANR trace、tombstone、堆转储与日志可能包含线程名、文件路径、URL、系统属性或内存片段。进入上传队列前要限制字节数、验证格式、删除不需要的数据，并应用项目的数据授权、保留和删除策略。无法可靠脱敏的附件不应上传。

采样和容量策略不能写成全项目固定比例。摘要预算按事件率、用户影响和上传成本确定；附件还要按网络、电量、磁盘、用户授权和诊断价值二次决策。崩溃循环时，端侧保留少量代表样本和丢弃计数，服务端按版本、进程和由退出原因与堆栈生成的故障签名限流。

误判与边界

多进程应用容易出现归因错位。getHistoricalProcessExitReasons(null, 0, maxNum) 会匹配调用者 UID 下的包，外部服务进程记录也可能被纳入。主进程读取到推送进程或外部服务进程的 REASON_LOW_MEMORY，不能直接算作主进程启动失败。查询包名、processName、package UID、real UID 和 defining UID 都要进入明细。

REASON_USER_REQUESTED 不能细分“在设置中强行停止（Force stop）”与“从最近任务（Recents）移除”。在 Android 14 / API 34 以前，包更新或组件状态变化还可能使用该 reason；API 34 才加入 REASON_PACKAGE_UPDATED 与 REASON_PACKAGE_STATE_CHANGE。跨版本报表必须结合系统 API 级别解释，不能把旧系统的全部 REASON_USER_REQUESTED 都标成用户行为。

REASON_USER_STOPPED 指多用户设备上的系统用户或工作资料被停止，与用户点击 Force stop 是两种事件。REASON_SIGNALED 只说明进程因操作系统信号退出；在不支持 LMK 分类上报的设备上，低内存终止可能表现为 SIGKILL，但其他原因也可能发送 SIGKILL。没有更多证据时，不能从信号编号反推唯一原因。

Android 17 的 AppExitInfoTracker.preventExitInfoUpdate() 会保护已有 REASON_ANR、REASON_CRASH 和 REASON_CRASH_NATIVE 记录，后续显式终止信息会形成新记录，减少相邻终止动作覆盖故障原因。这是 android-17.0.0_r1 的实现细节，不能外推为所有设备厂商或旧版本都一致的 SDK 保证。

Android 框架会把退出历史持久化，并在系统服务就绪（system ready）后加载，但公开 API 只承诺近期环形缓冲区记录。应用不能依赖固定文件路径、固定条数或跨重启永久保留。没有历史记录可能由缓冲淘汰、系统尚未记录、数据被清除或厂商实现差异造成，不能据此断定“进程未异常退出”。

退出原因与稳定性指标体系的映射

ApplicationExitInfo 可以补充 26.2 的 Crash 上报和 26.5 的证据包。服务端可按下表建立内部分类，但统计前要完成跨来源去重：

无崩溃用户比例（crash-free users）、ANR 率等产品指标需要稳定的用户分母和来源去重，不能只凭退出记录数量生成。报告同时保留用户可感知故障率、内部退出事件率与数据完整性；三者分别描述用户影响、系统记录数量和数据可信程度。

当前在线 API 参考还显示 REASON_MEMORY_LIMITER 与 REASON_ANOMALY，但两者标注为 API 10000，且不在 Android 17 / API 37 的公开 SDK 与 android-17.0.0_r1 源码中。覆盖 API 37 的数据协议不应提前引用这两个预览常量。

ApplicationExitInfo 与 GWP-ASan / MTE 报告拼接

GWP-ASan（抽样检测堆内存越界与释放后使用）、MTE（硬件内存标记扩展）和 HWASan（基于地址标记的原生内存错误检测器）发现内存安全错误时，进程可能以原生崩溃或 abort 结束。原生崩溃事件封装应保存构建是否启用相关工具、ABI、操作系统信号、故障地址、构建 ID 和工具提供的结构化信息；后续再用 REASON_CRASH_NATIVE 与 tombstone protobuf 补充系统现场。

关联时间容差要根据两类采集来源的时间精度、排队延迟和设备 wall clock 质量确定。processName、ABI、操作系统信号、故障地址、原生栈顶帧与构建 ID 一致时，可以提高匹配置信度。工具报告用于解释内存错误类型，tombstone 用于补充线程、寄存器、内存映射和系统现场信息；原始来源仍需保留。GWP-ASan/MTE 原理见 15.10、17.9 和 20.3。

低版本可观测性能力对照表

版本分支要以运行时 API 检测为准。API 30 及以上优先保存系统 reason，API 31 及以上尝试读取原生 tombstone，API 37 再读取 AnrInfo；任何一步缺失都回到轻量业务标记与独立的崩溃或 ANR 来源。系统记录提供分类证据，不能自动给出根因。

版本化采集能力与回退矩阵

退出记录建立被动诊断基线，Profiling API 增加主动或触发式采集。客户端要先探测能力，再按版本和结果交付状态回退。

同一个故障发生在 Android 10 和 Android 17 上，可取得的系统证据会有明显差异。诊断系统需要先判断设备版本和实际能力，再选择采集入口。版本号只说明 API 可能存在；系统是否生成附件，还取决于设备实现、后台采样、限流和故障类型。

平台源码锚点采用 android-17.0.0_r1。涉及旧版本时保留其公开 API 边界；涉及 Android 17 新行为时，以正式开发者文档和该标签下的源码为准。

三条诊断路径分别回答什么

Android 10 到 Android 17 的公开诊断能力可以分成三条路径。本文沿用平台术语 profile，泛指系统 trace、堆转储或采样结果；trigger 表示由系统事件触发采集的条件。

退出追溯记录进程终点。它适合确认应用无响应（ANR）、原生代码崩溃（native crash）、用户操作或系统资源处置，但通常缺少故障前的完整运行时序。应用请求采集针对可以控制的复现时段。系统事件触发采集依赖后台采样和限流，用来捕获难以预测的事件。

一次问题可以关联多条路径。例如，ANR 发生时系统可能生成触发式 system trace；进程随后被杀，下次启动又能读到 ApplicationExitInfo。两者应作为独立来源归档，再通过时间、进程和事件语义建立关联，不能因为时间相近就覆盖其中一份。

版本能力表

API 36.1 是 Android 16 的 minor SDK release（次版本 SDK 发布），同一大版本内也可以新增 API。它与 SdkExtensions.getExtensionVersion() 表示的 Mainline SDK Extension（可由模块更新提供的扩展版本）是两套版本机制。调用 36.1 新 API 前，应检查 Build.VERSION.SDK_INT_FULL >= Build.VERSION_CODES_FULL.BAKLAVA_1；SDK_INT 只记录大版本，SDK_INT >= 36 无法区分 36.0 和 36.1。Android 17 的 SDK_INT_FULL 高于该值，也满足条件。

Android 10–14：沿用前文退出证据

Android 10 只能依赖 App 自有状态、Crash SDK，以及受控场景下的 bug report 或 Perfetto；Android 11 才加入 ApplicationExitInfo。Android 12 开始，native crash 记录可能带 tombstone protobuf；Android 13、14 又补充了 freezer、包状态变化和包更新等 reason。

这些退出字段、trace 类型、低内存能力探测和低版本回退策略已在前半篇完整展开。这里不再复制读取代码和字段解释，只把它们作为版本矩阵中的“被动退出证据”，继续讨论 Android 15 之后的主动与触发式 profiling。

Android 15：应用请求 profiling

Android 15 / API 35 引入公开的 ProfilingManager。实现位于 Mainline Profiling 模块 packages/modules/Profiling；Mainline 模块是可以通过系统组件更新、无需完整系统 OTA 才能升级的 Android 组件。Android 17 的直接 API 签名为：

requestProfiling(int profilingType, Bundle parameters, String tag, CancellationSignal cancellationSignal, Executor executor, Consumer<ProfilingResult> listener)

应用也可以使用 AndroidX Profiling 提供的 request builder（请求构造器），减少直接维护 Bundle 参数和平台版本分支的成本。Bundle 是 Android 用键值对传递参数的容器。平台支持四种请求类型：

请求通过异步回调返回，并且可能不执行。系统级与进程级 rate limiter（频率限制器）、已有任务、执行或后处理错误、磁盘不足、非法参数都可能使请求失败；系统也可能延后开始。应用要归档 ProfilingResult#getErrorCode() 和可选的 getErrorMessage()，并把“请求已发出”和“结果已生成”作为两个状态。

结果回调有两个入口：

• 请求专用的 Executor 与 Consumer<ProfilingResult>，用于当前 requestProfiling()。Executor 决定在哪个线程执行回调，Consumer 接收结果对象。
• registerForAllProfilingResults() 注册的全局监听器，既接收应用请求结果，也接收系统 trigger 结果。

如果请求没有同时提供专用 listener / executor，进程也没有已注册的全局 listener / executor 组合，系统会丢弃该请求，不会启动采集。系统触发的结果没有请求现场的 callback（回调），只能经全局监听器交付；应用若在生成结果时未运行，下次启动并重新注册监听器后仍可能收到该结果。

成功文件的位置必须读取 ProfilingResult#getResultFilePath()。目录结构和文件命名属于实现细节，上传器不能自行拼接 /data/user/0/<package>/files/profiling/...。ProfilingResult 可直接读取 error code、error message、结果路径、tag（调用方附加的短标识）和 trigger type；它没有 getProfilingType()。主动请求时，应用要把请求类型和自有 request ID 一起保存。系统触发时，应根据 trigger type、tag 和收到的文件类型归档，数据模型中不要虚构 profiling type 字段。

Android 16-17：系统事件触发 profiling

trigger 注册表达的是“应用希望接收某类系统事件对应的采集结果”。系统不会持续运行后台 trace，而是在系统设定的时间范围内随机启动采样；事件发生时，只有后台 trace 正在运行、应用已注册且限流允许，系统才可能保存结果。后台 trace 使用 ring buffer（环形缓冲区），空间满后覆盖较早事件，所以附件通常保留触发前最近一段活动。

API 36

这两类结果都依赖系统当时存在可保存的后台 trace。ANR 的 ApplicationExitInfo trace 是线程堆栈文本，Perfetto system trace 是系统时间线；两者需要不同的解析器。

API 36.1

这些常量和方法在 API 36.1 才加入。同版本还增加 addAllProfilingTriggers()，用于注册当前进程对全部 trigger 的兴趣；若同一种 trigger 又通过 addProfilingTriggers() 单独注册，单独配置优先。接入代码要以 SDK_INT_FULL 对比 VERSION_CODES_FULL.BAKLAVA_1，并让 Android Lint 检查 minor SDK API。SDK_INT == 36 不能证明设备已经具备 36.1。

API 37

MemoryLimiter 的退出与触发证据

Android 17 在部分设备上实施 MemoryLimiter，且不受应用 targetSdkVersion 限制。被其终止的进程表现为 REASON_OTHER，getDescription() 包含精确字符串 "MemoryLimiter:AnonSwap"；命中限制时，TRIGGER_TYPE_ANOMALY 还可能提供 Java heap dump，但仍受设备覆盖、后台采样和限流约束。

只有这个文档明确保证的完整标记适合机器判断；不能匹配宽泛的 "MemoryLimiter"，也不能把所有 REASON_OTHER 都归入内存限制。MemoryLimiter kill 与 Java OutOfMemoryError 是不同事件：前者走 anomaly trigger，后者才对应 TRIGGER_TYPE_OOM。

TRIGGER_TYPE_OOM 依赖默认未捕获异常处理路径。UncaughtExceptionHandler 是线程异常无人处理时的末端回调；自定义 handler 如果不继续调用原默认 handler，系统无法使用这个 trigger。应用仍可在合适时机主动请求 Java heap dump，但要评估进程当时是否还有足够资源完成请求。

TRIGGER_TYPE_ANOMALY 的产物不能预设为一种格式。Android 17 文档列出的场景包括：命中系统内存限制时返回 heap dump，过量 Binder 调用时返回 stack sample；回调发生在系统实施相应处置之前。多个 package 共享同一 UID（多个包使用同一个系统身份）并同时注册某些异常 trigger 时，系统可能不提供附件。结果处理器应先看 trigger type、tag 和文件，再选择解析器。

TRIGGER_TYPE_COLD_START 会尽早启动一份新的 system trace 和 stack sampling profile，持续到应用调用 reportFullyDrawn()；未调用时，公开 API 文档给出的默认停止时间为 5 秒。它使用 discard buffer（满后丢弃新事件的缓冲区），以保留启动初期的内容。采集启动仍可能有延迟，因此产物不保证覆盖进程创建后的每个事件。

TRIGGER_TYPE_KILL_EXCESSIVE_CPU_USAGE 仍有官方文档差异：android-17.0.0_r1 源码注释和 2026-08-03 更新的 API reference 写的是后台 system trace 快照，Android 17 features 页面写的是 call-stack sample。接入端应保存系统返回的原始产物及文件类型，不能按 trigger 名写死解析器。本文以版本化源码和 API reference 作为接口语义锚点，并保留差异记录，等待官方文档统一。

证据归档：系统事实与应用推断分开

推荐把退出记录、profiling 结果、Crash SDK 样本和业务状态保存为不同记录类型。caseId 是应用生成的诊断案例编号，只负责建立关联，不能用它抹去来源差异。

退出记录字段

退出记录的持久去重指纹可以由 packageName + processName + packageUid + realUid + pid + timestampMs + reason + status 生成。系统会在进程退出后复用 PID，不能只用 PID 做主键。读取窗口可能重复返回同一条历史记录，因此应先按完整系统字段去重，再与客户端案例做候选关联。

profiling 结果字段

主动请求的去重指纹应包含 request ID、requested profiling type、tag 和文件 hash。系统 trigger 结果可使用 trigger type、tag、结果时间和文件 hash。若收到错误回调，应保存 error code；若应用通过其他来源确认事件发生，却没有收到 trigger callback，应另记“未收到 profiling 结果”。两种状态不能混为一个通用失败码，也不能靠立即重复请求掩盖系统限流。

常见事件的关联规则

时间接近只能生成候选关系。服务端应保留原记录，给关联关系附上算法版本和置信度，便于后续修正。

排障决策表

高版本能力是补充证据，不应导致低版本日志、指标和 Crash SDK 被删除。某个 trigger 在 API 上可用，也不表示每台设备、每次事件都能产生结果。

隐私、限流与采集成本

profiling 文件可能包含比普通日志更敏感的内容：

• Java heap dump 可能保存对象字段、缓存、请求参数和页面状态。
• system trace 可能出现方法名、线程名、调度时序、Binder 交互及部分系统现场信息。
• stack sampling 和 heap profile 会暴露代码结构、调用栈或分配路径。
• ANR trace、tombstone 与 minidump 可能包含路径、寄存器、映射和构建信息。

采集设计至少要包含用户授权或适用的合规依据、数据最小化、传输与静态加密、访问审计、保留期限、删除机制和远程关闭能力。tag、caseId 和文件名中不要放用户输入、账号、URL、token 或其他敏感值。

采集预算应来自设备实验和线上观测。system trace 按时长与缓冲大小评估，stack sampling 按采样频率评估，heap dump 按停顿、峰值内存和文件大小评估。配置应区分诊断案例、版本、设备和采集类型；系统 rate limiter 之外，应用仍需自己的并发控制与预算。命中限流或跳过采集时，上报轻量状态和原因，不要立即循环重试。

与 26.3 证据包模板的关系

26.3 负责问题受理、复现步骤、远程日志、灰度处置和问题单流程。版本化的“系统诊断附件”包括：

• ApplicationExitInfo 退出记录及可选 ANR/native 附件；
• 应用请求产生的 system trace、heap dump、heap profile 或 stack sampling；
• trigger 产生的文件、tag、trigger type 和错误状态；
• 每份文件的来源、hash、大小、采集时间、系统版本、权限和保留期限。

问题单展示时应保留来源标签。值班人员需要知道某个结论来自系统退出记录、App 自有日志还是 profiling 文件，才能判断证据强度。

版本矩阵与 Profiling 的源码、文档锚点

• ApplicationExitInfo.java（android-17.0.0_r1）
• ActivityManager.java（android-17.0.0_r1）
• ProfilingManager.java（android-17.0.0_r1）
• ProfilingResult.java（android-17.0.0_r1）
• ProfilingTrigger.java（android-17.0.0_r1）
• ApplicationExitInfo API reference
• ProfilingManager API reference
• ProfilingResult API reference
• ProfilingTrigger API reference
• App-driven profiling
• Trigger-based profiling
• Profiling limitations
• Android 17：影响所有应用的行为变更
• Android 17：功能与 API
• Build.VERSION API reference
• Build.VERSION_CODES_FULL API reference

全文小结

ApplicationExitInfo 可以补充进程来不及上报的退出分类，并把 ANR trace、原生 tombstone、最近一次 importance 与应用状态放到同一份证据记录中。公开 API 不提供 subreason，PSS/RSS 只是最近一次采样值，历史条数与附件都可能缺失；服务端必须保留缺失状态和来源关系。

Android 15 之后的 ProfilingManager 和 trigger-based profiling 补上了主动、事件前后采集，但 API 存在不等于一定有产物。诊断系统应先做完整版本与能力探测，再分别归档退出记录、profiling 结果和 App 自有证据；Android 17 的 AnrInfo、MemoryLimiter 标记等高版本信息只用于增强证据，不能替代低版本回退、符号文件和可重复实验。

参考资料

• AOSP Android 17：ApplicationExitInfo
• AOSP Android 17：ActivityManager
• AOSP Android 17：AppExitInfoTracker
• AOSP Android 17：退出历史默认容量配置
• AOSP Android 17：NativeTombstoneManager
• AOSP Android 17：tombstone.proto
• ApplicationExitInfo API
• ApplicationExitInfo.AnrInfo API 37
• ActivityManager 退出历史与进程状态摘要 API
• Android ANR 诊断
• Android NDK Native crash 调试
• KOOM 源码仓库