"应用闪退了,不知道为什么"

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


▲ 示意图 · 故障日志与崩溃治理

接住 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 接住异常、附上版本设备页面堆栈、断网落盘补传、按堆栈定位修复、每周复盘收敛同类写法。那句"打开就闪退"的用户,在下一版里变成了"更新后不闪退了"的好评。线上问题排查的水平,取决于崩溃发生那一刻你手里有多少信息——信息是在问题发生之前埋好的。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐