跳到主要内容

使用Crashpad收集Web组件崩溃信息

Web组件支持使用Crashpad记录进程崩溃信息。Crashpad是Chromium内核提供的进程崩溃信息处理工具,在应用使用Web组件导致的进程(Web渲染进程)崩溃出现后,Crashpad会在应用主进程沙箱目录写入dmp文件。该文件为二进制格式,后缀为dmp,其记录了进程崩溃的原因、线程信息、寄存器信息等,应用可以使用该文件分析Web组件相关进程崩溃问题。Web组件分别从API version 9和API version 12开始支持接口onRenderExited和onRenderProcessNotResponding,开发者可以分别通过Web接口onRenderExitedonRenderProcessNotResponding来检测渲染进程退出和渲染进程不响应,也可以在这些接口中增加应用处理的逻辑。

使用步骤如下:

  1. 在应用使用Web组件导致的进程崩溃出现后,Crashpad收到信号,对应Hilog日志(节选部分)如下
pid-30069 I [crashpad_ohos.cc:254] crashpad SandboxedHandler::HandleCrash, received signo = 6
pid-30069 I [crashpad_ohos.cc:182] crashpad SandboxedHandler::HandleCrashNonFatal, connect to handler successfully, need to request dump
...
arkweb_cr..._handler I [crash_report_database.cc:91] crash dmp path : /data/storage/el2/log/crashpad/new/xxx.dmp

这时Crashpad开始请求dump,成功之后,会在应用主进程沙箱目录下产生对应的dmp文件,对应的沙箱路径如下:

/data/storage/el2/log/crashpad
  1. 参考Native访问应用沙箱实现访问应用沙箱dmp文件;也可将存放dmp文件的沙箱路径的文件复制到可以查看的路径。示例如下
import { fileIo as fs } from '@kit.CoreFileKit'
import { BusinessError } from '@kit.BasicServicesKit'
import { webview } from '@kit.ArkWeb'

@Entry
@Component
struct Index {
controller: webview.WebviewController = new webview.WebviewController();
uiContext: UIContext = this.getUIContext();
build() {
RelativeContainer() {
Web({src:'chrome://memory-exhaust/', controller:this.controller})
Button('file')
.onClick(() => {
let pathDir = this.uiContext.getHostContext()?.filesDir;
console.info("pathdir=" + pathDir);
fs.copyDir("/data/storage/el2/log/crashpad/pending/", pathDir, 0)
.then(()=>{
console.info("copy files success");
})
.catch((err: BusinessError)=>{
console.error("copy failed with error message: " + err.message + ", error code: " + err.code);
})
})
}
.height('100%')
.width('100%')
}
}

以上示例将所有的dmp文件都复制到可查看的沙箱路径中,也可以搜索Hilog日志“.dmp”得到dmp文件名,这样就可以将某个dmp文件复制到另一个沙箱路径下了,具体的路径为

/data/app/el2/100/base/com.example.myapplication/haps/entry/files/

这个路径可以利用DevEco Studio查看。

  1. 获取dmp文件后进行解析,具体步骤如下:

    • 通过minidump_stackwalk工具解析dmp文件,可以得到上述dmp文件对应的进程崩溃信息(崩溃的原因、线程信息、寄存器信息等),示例如下(Linux环境):

      ./minidump_stackwalk b678e0b5-894b-4794-9ab3-fb5d6dda06a3.dmp > parsed_stacktrace.txt

      minidump_stackwalk由Breakpad项目源码编译得到,编译方法见项目仓库:Breakpad仓库地址

    • 查看解析后的文件,以下示例列出部分内容:

      Crash reason: SIGSEGV /SEGV_MAPERR 表示导致进程crash的信号,此处示例为段错误
      Crash address: 0x0
      Process uptime: 12 seconds

      Thread 0 (crashed) 表示Thread 0发生crash
      0 libweb_engine.so + 0x2e0b340 0层调用栈,0x2e0b340为so偏移地址,可用来反编译解析crash源码(依赖unstripped so)
      x0 = 0x00000006a5719ff8 x1 = 0x000000019a5a28c0
      x2 = 0x0000000000020441 x3 = 0x00000000000001b6
      x4 = 0x0000000000000018 x5 = 0x0000000000008065
      x6 = 0x0000000000008065 x7 = 0x63ff686067666d60
      x8 = 0x0000000000000000 x9 = 0x5f129cf9e7bf008c
      x10 = 0x0000000000000001 x11 = 0x0000000000000000
      x12 = 0x000000069bfcc6d8 x13 = 0x0000000009a1746e
      x14 = 0x0000000000000000 x15 = 0x0000000000000000
      x16 = 0x0000000690df4850 x17 = 0x000000010c0d47f8
      x18 = 0x0000000000000000 x19 = 0x0000005eea827db8
      x20 = 0x0000005eea827c38 x21 = 0x00000006a56b1000
      x22 = 0x00000006a8b85020 x23 = 0x00000020002103c0
      x24 = 0x00000006a56b8a70 x25 = 0x0000000000000000
      x26 = 0x00000006a8b84e00 x27 = 0x0000000000000001
      x28 = 0x0000000000000000 fp = 0x0000005eea827c10
      lr = 0x000000069fa4b33c sp = 0x0000005eea827c10
      pc = 0x000000069fa4b340
      Found by: given as instruction pointer in context
      1 libweb_engine.so + 0x2e0b338
      fp = 0x0000005eea827d80 lr = 0x000000069fa48d44
      sp = 0x0000005eea827c20 pc = 0x000000069fa4b33c
      Found by: previous frame's frame pointer
      2 libweb_engine.so + 0x2e08d40
      fp = 0x0000005eea827e50 lr = 0x00000006a385cef8
      sp = 0x0000005eea827d90 pc = 0x000000069fa48d44
      Found by: previous frame's frame pointer
      3 libweb_engine.so + 0x6c1cef4
      fp = 0x0000005eea828260 lr = 0x00000006a0f11298
      sp = 0x0000005eea827e60 pc = 0x00000006a385cef8
      ......
    • 使用LLVM工具链解析崩溃源码位置,需要注意的是,要解析的so文件必须是带有符号表的so文件,如果栈显示和web的so相关,开发者可以在社区提issue或IR单。示例如下(Linux环境):

      ./llvm-addr2line -Cfpie libweb_engine.so 0x2e0b340

      llvm-addr2line工具链位于SDK中。