文档管理中心
指南应用框架ArkWeb(方舟Web)Web调试维测使用Crashpad收集Web组件崩溃信息

使用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中。

在 指南 中进行搜索
请输入您想要搜索的关键词