本原创文章帖发布在华为开发者联盟社区，欢迎开发者前往访问评论交流，更多与该内容相关讨论，请点击原帖查看：

应用退出不知道原因？HarmonyOS有账本-华为开发者话题 | 华为开发者联盟

      在移动端应用开发过程中，可能出现应用闪退、后台被强制退出等异常行为。除崩溃、Freeze 等显性故障外，也存在系统资源调度引发的非故障类退出，仅依靠传统故障日志，无法完整还原退出现场，给问题排查带来较大阻碍。 针对这一痛点，HarmonyOS 6.1 上线 HiAppEvent 退出原因订阅能力，通过系统级事件采集，记录应用上一次应用退出的全量原因，助力开发者高效完成异常数据汇总与根因分析。下文将对该机制的原理、开发实践及应用场景展开详细解读。

一、背景与挑战

1.1 当前应用退出痛点

      • 退出原因记录分散：系统杀应用逻辑分散在多个模块（如资源管控、故障处理、后台任务管理等），缺乏统一的维测接口。

      • 区分退出是否是故障：部分退出原因是正常的用户行为，或者是系统正常的后台管理行为，需要剔除这些正常退出原因，关注消费产品使用者体验层面的异常问题。

1.2 常见退出场景分类

二、通过HiAppEvent订阅机制获取上次退出原因

2.1 核心能力

      • 订阅接口：hiAppEvent.addWatcher支持订阅hiAppEvent.event.APP_KILLED系统事件 。

      • 数据模型：通过eventInfo.params.reason获取退出原因

2.2 开发实践示例

hiAppEvent.addWatcher({
  // 开发者可以自定义观察者名称，系统会使用名称来标识不同的观察者
  name: "watcher",
  // 开发者可以订阅感兴趣的系统事件，此处是订阅了应用终止事件
  appEventFilters: [
    {
      domain: hiAppEvent.domain.OS,
      names: [hiAppEvent.event.APP_KILLED]
    }
  ],
  // 开发者可以自行实现订阅实时回调函数，以便对订阅获取到的事件数据进行自定义处理
  onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {
    hilog.info(0x0000, 'testTag', `HiAppEvent onReceive: domain=${domain}`);
    for (const eventGroup of appEventGroups) {
      // 开发者可以根据事件集合中的事件名称区分不同的系统事件
      hilog.info(0x0000, 'testTag', `HiAppEvent eventName=${eventGroup.name}`);
      for (const eventInfo of eventGroup.appEventInfos) {
        // 开发者可以对事件集合中的事件数据进行自定义处理，此处是将事件数据打印在日志中
        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.domain=${eventInfo.domain}`);
        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.name=${eventInfo.name}`);
        // 开发者可以获取到应用终止事件发生的时间戳
        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.time=${eventInfo.params['time']}`);
        // 开发者可以获取到应用的前后台状态
        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.foreground=${eventInfo.params['foreground']}`);
        // 开发者可以获取到应用终止事件发生的原因
        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.reason=${eventInfo.params['reason']}`);
        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.app_running_unique_id=${eventInfo.params['app_running_unique_id']}`);
        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.bundle_version=${eventInfo.params['bundle_version']}`);
      }
    }
  }
});

2.3 数据采集维度

三、开发案例：崩溃聚类分析实战

3.1 案例背景

      某应用在鸿蒙6.1升级后出现高频崩溃，传统日志分析难以定位共性诱因。通过HiAppEvent订阅机制，开发者获取到以下关键数据：

      • 崩溃类型分布：JS Crash占比62%，CppCrash占比38%。

      • 资源管控诱因：整机内存管控触发的后台进程终止占比75%。

3.2 基本架构

3.3 聚类分析流程

      1. 数据清洗：提取eventInfo.params.reason中的关键词（如RssThresholdKiller、LowMemoryKill）。如果只关注前台应用闪退，则过滤eventInfo.params.foreground

      2. 聚类算法：对崩溃事件reason进行聚类，识别高频模式。

  3. 数据关联，根因定位：针对聚类中心事件，通过app_running_unique_id字段和hiAppEvent.event.APP_CRASH事件日志进行关联。

3.3 修复效果

附：官方文档

   1. 应用终止事件介绍，含订阅示例代码：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-killed-events?zxqy-IT&ha_sourceId=89000468

 2. App Killed（应用终止）检测 https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/appkilled-guidelines?zxqy-IT&ha_sourceId=89000468

   3. 应用异常退出类问题检测方法  https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-stability-runtime-exception-exit-detection?zxqy-IT&ha_sourceId=89000468

  4. 应用被查杀类问题分析方法  https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-stability-app-killed-way?zxqy-IT&ha_sourceId=89000468