崩溃事件介绍

概述

崩溃是指应用进程非预期退出。以下两种场景会生成崩溃事件：

1. Native代码未处理崩溃异常信号时，会生成崩溃事件。
2. Js/ArkTS代码未处理异常时，会生成崩溃事件。

本文面向开发者介绍崩溃事件各字段的含义及规格。如需了解如何使用HiAppEvent接口订阅系统崩溃事件，请参考以下文档。目前提供ArkTs和C/C++两种接口，按需选择。

• 订阅崩溃事件（ArkTS）。
• 订阅崩溃事件（C/C++）。

事件字段说明

params字段说明

崩溃事件信息中params属性的详细描述如下：

名称	类型	说明
time	number	事件触发时间，单位为毫秒。
crash_type	string	崩溃类型。支持NativeCrash（native代码异常）和JsError（js代码异常）两种崩溃类型。问题分析请分别参考CppCrash（NativeCrash）分析指南和JsCrash（JsError）分析指南。
foreground	boolean	应用是否处于前台状态。true表示应用处于前台状态；false表示应用处于后台状态。
bundle_version	string	应用版本。
bundle_name	string	应用名称。
pid	number	应用的进程ID。
uid	number	应用的用户ID。
uuid	string	根据故障信息生成的故障特征码，用于标识特征相同的崩溃故障。
exception	object	异常信息, 详见exception字段说明。包含故障简要信息，全量故障信息见external_log文件。
hilog	string[]	日志信息，最多显示100行hilog日志。更多日志请查看故障日志文件。
threads	object[]	全量线程调用栈，详见thread字段说明。仅NativeCrash类型的崩溃事件提供。
external_log12+	string[]	故障日志文件路径。为避免目录空间超限导致新生成的日志文件写入失败，日志文件处理完后请及时删除，超限规格请参考log_over_limit字段。
log_over_limit12+	boolean	生成的故障日志文件与已存在的日志文件总大小是否超过5M上限。true表示超过上限，日志写入失败；false表示未超过上限。

exception字段说明

JsError类型exception字段说明

名称	类型	说明
name	string	异常类型。
message	string	异常原因。
stack	string	异常调用栈。

NativeCrash类型exception字段说明

名称	类型	说明
message	string	异常原因。
signal	object	信号信息，详见signal字段说明。
thread_name	string	线程名称。
tid	number	线程ID。
frames	object[]	线程调用栈，详见frame字段说明。

signal字段说明

信号详细介绍请参考CppCrash分析指南崩溃信号说明。

名称	类型	说明
signo	number	信号值。
code	number	信号二级分类。
address	string	访问出错的地址。

thread字段说明

名称	类型	说明
thread_name	string	线程名称。
tid	number	线程ID。
frames	object[]	线程调用栈，详见frame字段说明。

frame字段说明

Native帧frame字段说明

名称	类型	说明
file	string	文件名称。
symbol	string	函数名称。symbol为空可能是由于以下两种原因： 1. 二进制文件中没有保存该函数名信息。 2. 函数名称长度超过256字节时将被全部删除，以防止超长字符串引起未知问题。
buildId	string	文件唯一标识。文件可能没有buildId，请参考CppCrash分析指南崩溃日志内容说明。
pc	string	程序执行的指令在文件内的偏移十六进制字节数。
offset	number	程序执行的指令在函数内偏移字节数。

Js帧frame字段说明

名称	类型	说明
file	string	文件名。
packageName	string	模块的包名。
symbol	string	函数名称。
line	number	异常所在代码行号。
column	number	异常所在代码列号。