HiAppEvent常见问题

查不到已通过HiAppEvent订阅的事件内容

问题现象

在开发调试阶段，崩溃、应用冻屏等故障发生后，无法在DevEco Studio的HiLog窗口中获取已通过HiAppEvent订阅的事件内容。

可能的原因&解决措施

发生崩溃、应用冻屏等故障后，应用已退出。

解决办法：再次启动应用，查看相应的事件内容。

无法获取external_log日志文件

问题现象

Hilog中出现如下日志：

• eventInfo.params.external_log=[]
• HiAppEvent file does not exist

可能的原因&解决措施

情况一：

external_log日志文件所在目录的空间已达到上限。

external_log所在的目录为应用沙箱目录，目录空间受限。log_over_limit字段用于判断external_log日志文件所在目录的空间是否达到上限。如果log_over_limit的值为true，表示external_log日志文件所在目录空间已达到上限，事件包含的日志文件将无法写入。

external_log是一个字符串数组。例如：

external_log=["/data/storage/el2/log/hiappevent/APP_CRASH_时间戳_xxxx.log"]。

可采取的解决措施：

参考无法删除external_log日志文件中的解决措施，清理历史日志文件。

情况二：

部分系统事件（如启动耗时事件）本身没有external_log，因而没有external_log日志文件。

可采取的解决措施：

查看对应的事件介绍章节，确认事件是否包含external_log：系统事件。

情况三：

事件发生在事件订阅之前。

在调用事件订阅接口addWatcher()前，没有开始监听系统事件。因此事件订阅之前的事件没有external_log日志文件。

可采取的解决措施：

确认事件订阅与事件发生的时序关系。先事件订阅，然后事件发生，才能获取到事件的external_log日志文件。

情况四：

系统事件没有触发成功。

如果系统事件没发生，就不会有external_log日志文件。

可采取的解决措施：

查看系统事件的其他日志，确认系统事件是否已经触发成功。

情况五：

external_log日志文件生成后又被删除了。

例如，在一个应用中，A和B两个模块都订阅了系统事件C。A模块处理完系统事件C的回调后，删除了external_log日志文件。随后B模块在系统事件C的回调中访问external_log日志文件，会提示日志文件不存在。

可采取的解决措施：

检查其他模块是否已删除external_log日志文件。

无法删除external_log日志文件

问题现象

external_log日志文件所在目录的空间已达到上限，但无法删除external_log日志文件。

解决措施

• 开发者如果有权限访问设备的“/data/app/el2/100/log/应用包名”目录，可以手动删除external_log日志文件。文件目录为/data/app/el2/100/log/应用包名/hiappevent（或resourcelimit或watchdog）。
• 开发者若没有权限访问设备的“/data/app/el2/100/log/应用包名”目录，可以在应用代码中删除external_log日志文件。代码示例如下。文件删除接口可以参考fileIo.unlink。

代码示例

import { fileIo } from '@kit.CoreFileKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hiAppEvent, hilog } from '@kit.PerformanceAnalysisKit';

  hiAppEvent.addWatcher({
    // 开发者可以自定义观察者名称，系统会使用名称来标识不同的观察者
    name: "AppCrashWatcher",
    // 订阅过滤条件，这里是订阅了系统事件中的崩溃事件
    appEventFilters: [
      {
        domain: hiAppEvent.domain.OS,
        names: [hiAppEvent.event.APP_CRASH]
      }
    ],
    // 实现onReceive回调，监听到事件后实时回调
    onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {
      hilog.info(0x0000, 'testTag', `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.params.time=${JSON.stringify(eventInfo.params['time'])}`);
          // 开发者可以获取到崩溃应用的包名
          hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.bundle_name=${JSON.stringify(eventInfo.params['bundle_name'])}`);
          // 开发者可以获取到崩溃事件发生时的故障日志文件
          hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.external_log=${JSON.stringify(eventInfo.params['external_log'])}`);

          if (eventInfo.params['external_log'] != undefined) {
            for (let index = 0; index < eventInfo.params['external_log'].length; ++index) {
              let externalLog: string = eventInfo.params['external_log'][index];
              hilog.info(0x0000, 'testTag', `externalLog=${externalLog}`);
              // 验证访问权限：
              let res = fileIo.accessSync(externalLog);
              if (res) {
                hilog.info(0x0000, 'testTag', `HiAppEvent file exists`);
              } else {
                hilog.error(0x0000, 'testTag', `HiAppEvent file does not exist`);
              }
              // 验证读写权限：
              fileIo.open(externalLog, fileIo.OpenMode.READ_WRITE).then((file: fileIo.File) => {
              hilog.info(0x0000, 'testTag', `HiAppEvent file=${externalLog} fd=${file.fd}`);
              fileIo.closeSync(file);
              }).catch((err: BusinessError) => {
                hilog.info(0x0000, 'testTag',
                `HiAppEvent open file=${externalLog} failed with error message=${err.message}, error code=${err.code}`);
              });
              // 删除external_log日志文件：
              fileIo.unlink(externalLog).then(() => {
                console.info("HiAppEvent remove file:" + externalLog + " succeed");
              }).catch((err: BusinessError) => {
                console.error("HiAppEvent remove file:" + externalLog + " failed with error message: " + err.message +
                ", error code: " + err.code);
              });
            }
          }
        }
      }
    }
  });

访问及删除external_log日志文件的日志：

externalLog=/data/storage/el2/log/hiappevent/APP_CRASH_1751081104816_35595.log
HiAppEvent file exists
HiAppEvent file=/data/storage/el2/log/hiappevent/APP_CRASH_1751081104816_35595.log fd=61
HiAppEvent remove file:/data/storage/el2/log/hiappevent/APP_CRASH_1751081104816_35595.log succeed

external_log返回的路径是应用沙箱目录，非真实物理路径。应用有权限访问自己的沙箱目录。external_log日志空间受限，应用处理完日志文件后应及时删除。

同一应用内，事件的回调不区分线程、进程

例如，在同一个应用内，有A、B两个进程，进程A已调用addWatcher()接口订阅崩溃事件。如果进程B发生崩溃，进程A能收到进程B的崩溃回调。只要进程A和B的应用名一致即可。

接口参考链接

hiAppEvent.addWatcher。