• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 分析JS Crash（进程崩溃）
2
3当未处理的JS异常导致应用意外退出时，应用会在抛出未处理的异常时崩溃并且会生成对应的JS Crash崩溃日志文件。开发者可通过错误日志查看引起崩溃的代码位置及分析应用崩溃的原因。
4
5本文将分别介绍获取进程崩溃日志的三种方式，以及如何进行崩溃日志分析。
6
7## 获取方式
8
9进程崩溃日志是一种故障日志，与应用无响应日志、JS应用崩溃等都由FaultLogger模块管理，可通过如下三种方式获取：
10
11- 方式一：通过shell获取日志
12
13    进程崩溃后，JSCrash文件会生成在“设备/data/log/faultlog/faultlogger/”路径下，故障日志文件名格式为“jscrash-进程名-进程UID-秒级时间”，包含设备名、系统版本、进程崩溃调用栈等信息。
14
15    ![](figures/jscrash.png)
16
17- 方式二：通过DevEco Studio获取日志
18
19    DevEco Studio会收集“设备/data/log/faultlog/faultlogger/”路径下的进程崩溃故障日志并归档在FaultLog下，获取日志的方法可参考[DevEco Studio使用指南-FaultLog](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V2/ide-debug-hilog-0000001172459337-V2#section974519209435)。
20
21- 方式三：通过faultlogger接口获取
22
23    faultlogger对外提供了故障查询接口，可以查询各种故障信息，详见[@ohos.faultLogger (故障日志获取)](../reference/apis-performance-analysis-kit/js-apis-faultLogger.md)。
24
25## 进程崩溃日志分析
26
27三种方式获取到的日志是无差异的。jscrash多为应用问题，开发者可通过崩溃文件中的 Error message 和 StackTrace 来定位问题。
28
29以下是进程崩溃日志信息中对应字段解释。
30
31```
32Build info:ALN-AL00 4.1.0.30(SP4C00E30R4P8log) <- 版本信息
33Module name:com.example.myapplication <- 模块名
34Version:1.0.0 <- 版本号
35Pid:579 <- 进程号
36Uid:0 <- 用户ID
37Reason:TypeError <- 原因
38Error message:Cannot read property c of undefined <- 异常信息
39Cannot get SourceMap info, dump raw stack: <- js栈通过sourcmap行列号解析失败
40SourceCode:
41        var a = b.c;   <-异常代码位置
42                ^
43Stacktrace:
44    at onPageShow (entry/src/main/ets/pages/Index.ets:7:13)  <-异常代码调用栈
45           ^                                      ^
46         函数名异常代码文件行列号位置
47```
48
49## 通过日志分析问题
50
51日志分析会有如下两种情况：
52
53- **情况一：可跳转至引起错误的代码行**
54
55  如果FaultLog的堆栈信息中的链接或偏移地址指向的是当前工程中的某行代码，该段信息将被转换为超链接形式，在DevEco Studio中点击后跳转至对应代码行。
56
57- **情况二：不可跳转至引起错误的代码行或者跳转代码位置不存在**
58
59  如出现`Cannot get Source Map info, dump raw stack`信息代表js栈转换ets行列号失败，在DevEco Studio中点击链接会跳转到不正确的代码位置或不存在的代码行位置。
60
61  应用代码运行出错时，会打印错误栈信息。如果ts栈转换ets行列号失败时错误栈的后缀仍显示为ets，开发者需要在build目录下编译中间产物以生成ts代码，在js代码中定位对应错误代码行。可参考：[应用堆栈解析](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V2/release-app-stack-analysis-0000001421224074-V2)。
62