线上崩溃只剩一行日志,鸿蒙故障日志的正确用法
"应用闪退了,不知道为什么"
客服转来的用户反馈只有一句话:打开就闪退。没有机型、没有操作路径、没有堆栈,按这个信息量排查等于蒙眼走路。线上崩溃治理的第一课是让每一次崩溃都带着完整的上下文回来,这篇讲鸿蒙侧崩溃监控的接入和日志怎么用。

▲ 示意图 · 故障日志与崩溃治理
接住 JS 异常
应用未捕获的异常会导致闪退,系统会记录故障日志,但应用侧要主动接入才能"第一时间知道"并附带上报。入口是 errorManager。
import { errorManager } from '@kit.AbilityKit';
// 在 AbilityStage 里尽早注册
onCreate(): void {
errorManager.on('error', (err) => {
// name / message / stack 都在里面
this.reportCrash(err);
});
}
private reportCrash(err: Error): void {
const payload = {
version: APP_VERSION, // 版本号,归因的第一维度
device: deviceInfo.marketName, // 机型分布
page: routeStore.currentPage, // 崩溃时的页面
message: err.message,
stack: err.stack?.slice(0, 4000) // 堆栈截断,别一次推几 MB
};
reportService.push('js_crash', payload);
}
三个字段决定了排查效率:版本号把崩溃圈定到某次发版;页面上下文还原用户路径;堆栈定位到具体代码行。上线当天收到三条堆栈一致的崩溃,五分钟就锁定是某个空指针分支——堆栈完整时,崩溃修复通常以分钟计。
上报的纪律
崩溃上报本身要防连环坑:上报代码如果又抛异常,会陷入递归,所以 report 逻辑必须 try 包裹、绝不调用业务代码;单条日志截断长度,批量错峰上报,别在崩溃的当口发起大请求;本地落盘一份(faultLogger 记录的系统故障日志加上报缓存),网络恢复后补传,弱网用户的崩溃不丢失。还有隐私红线:日志里不带用户内容,只带技术上下文,堆栈里如果可能包含用户数据要脱敏。
日志怎么读
拿到堆栈先看三样:异常类型(空引用、类型转换、数组越界,各自指向不同类的错误)、发生在哪个异步回调(异步崩溃的现场往往不是根因现场)、版本聚合后的首次出现版本(新版本引入还是历史遗留)。我们的那次空指针,堆栈显示在某个异步回调里读了一个可能为 null 的配置项,修复加判空,同时把这条配置的初始化提前到应用启动,同类的三处隐患一起清掉。
治理指标与防复发
监控的价值在趋势。我们盯两个数字:崩溃率(崩溃次数除以启动次数,千分之一以下是健康线)和 Top 崩溃列表的收敛速度。每周复盘一次 Top 五崩溃,修复的不只是那一处判空,而是同一类的写法——那次空指针之后,团队约定所有配置读取走统一的兜底函数,这一类崩溃从统计里消失了。
写在最后
崩溃治理的闭环是:errorManager 接住异常、附上版本设备页面堆栈、断网落盘补传、按堆栈定位修复、每周复盘收敛同类写法。那句"打开就闪退"的用户,在下一版里变成了"更新后不闪退了"的好评。线上问题排查的水平,取决于崩溃发生那一刻你手里有多少信息——信息是在问题发生之前埋好的。
更多推荐




所有评论(0)