Dart 堆栈符号化

概述当 Flutter 应用在 Release 或 Profile 模式下发生卡死AppFreeze或崩溃CppCrash时相关日志中通常会包含dart层的堆栈信息libapp.so部分但获取到的堆栈地址是十六进制偏移量无法直接看到具体的 Dart 函数和行号。需要使用flutter symbolize工具将原始堆栈地址转换为可读的 Dart 源代码位置。工具工具:flutter symbolize输入: 需要符号化的堆栈文件 符号文件输出: 符号化后的堆栈文件命令flutter symbolize-i堆栈文件-d符号文件-o符号化后输出文件获取符号文件符号文件在打包阶段生成。构建 HAP 包时追加--split-debug-info参数意思是剥离调试信息需要传入一个文件夹的路径如flutter build hap--release--split-debug-info./debug-info打包时会将符号信息从libapp.so中分离出来生成在指定目录下如./debug-info/app.ohos-arm64.symbols生成堆栈文件AppFreeze 日志、CppCrash 日志或 Hiprofler 抓取的 trace 文件中通常会包含dart层的堆栈信息libapp.so部分但需要转换为flutter symbolize工具可识别的格式。原始堆栈格式来自日志#00 pc 0000000000171698 /data/storage/el1/bundle/libs/arm64/libapp.so(301f78813ec57f68e57e8d5453ab0d89) #01 pc 00000000001537b4 /data/storage/el1/bundle/libs/arm64/libapp.so(301f78813ec57f68e57e8d5453ab0d89) ...转换后的堆栈格式#00 abs 0000000000171698 virt 0000000000171698 libapp.so #01 abs 00000000001537b4 virt 00000000001537b4 libapp.so ...说明#xx: 调用栈中的帧编号pc: 程序计数器 - 表示指令指针地址0000000000xxxxxx: 十六进制地址/data/storage/.../libapp.so: 共享库路径(301f78813ec57f68e57e8d5453ab0d89): 构建指纹/哈希值示例AppFreeze 堆栈符号化1. 准备输入文件将转换后的堆栈保存为input.txt#00 abs 0000000000171698 virt 0000000000171698 libapp.so #01 abs 00000000001537b4 virt 00000000001537b4 libapp.so #02 abs 0000000000281fe4 virt 0000000000281fe4 libapp.so #03 abs 000000000023e2b4 virt 000000000023e2b4 libapp.so #04 abs 000000000022ae88 virt 000000000022ae88 libapp.so #05 abs 0000000000234b8c virt 0000000000234b8c libapp.so #06 abs 0000000000237f2c virt 0000000000237f2c libapp.so #07 abs 0000000000237cd0 virt 0000000000237cd0 libapp.so #08 abs 0000000000278d3c virt 0000000000278d3c libapp.so #09 abs 0000000000146204 virt 0000000000146204 libapp.so #10 abs 000000000024df24 virt 000000000024df24 libapp.so #11 abs 0000000000146190 virt 0000000000146190 libapp.so #12 abs 00000000001460f8 virt 00000000001460f8 libapp.so #13 abs 00000000001458d4 virt 00000000001458d4 libapp.so #14 abs 000000000027d6a4 virt 000000000027d6a4 libapp.so #15 abs 0000000000179014 virt 0000000000179014 libapp.so #16 abs 0000000000178f54 virt 0000000000178f54 libapp.so #17 abs 0000000000178a40 virt 0000000000178a40 libapp.so #18 abs 000000000028dadc virt 000000000028dadc libapp.so #19 abs 000000000025bd20 virt 000000000025bd20 libapp.so #20 abs 00000000000dffc4 virt 00000000000dffc4 libapp.so #21 abs 00000000000ec878 virt 00000000000ec878 libapp.so #22 abs 00000000000ec808 virt 00000000000ec808 libapp.so #23 abs 00000000000ed5d4 virt 00000000000ed5d4 libapp.so #24 abs 00000000000dca20 virt 00000000000dca20 libapp.so2. 执行符号化命令flutter symbolize-iinput.txt-dapp.ohos-arm64.symbols-osymbols.txt3. 查看符号化结果symbols.txt内容如下#0 _MyHomePageState._dartFreeze (D:/Flutter/demo/flutter_dfx_sample/lib/main.dart:44:5) #1 _MyHomePageState._dartFreeze (D:/Flutter/demo/flutter_dfx_sample/lib/main.dart:41:3) #2 _InkResponseState.handleTap (D:/Flutter/flutter_flutter/packages/flutter/lib/src/material/ink_well.dart:1195:3) #3 GestureRecognizer.invokeCallback (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/recognizer.dart:345:24) #4 TapGestureRecognizer.handleTapUp (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/tap.dart:737:11) #5 BaseTapGestureRecognizer._checkUp (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/tap.dart:362:5) #6 BaseTapGestureRecognizer.handlePrimaryPointer (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/tap.dart:293:7) #7 PrimaryPointerGestureRecognizer.handleEvent (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/recognizer.dart:706:9) #8 PrimaryPointerGestureRecognizer.handleEvent (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/recognizer.dart:688:3) #9 PointerRouter._dispatch (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/pointer_router.dart:97:12) #10 PointerRouter._dispatchEventToRoutes.anonymous closure (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/pointer_router.dart:143:9) #11 _LinkedHashMapMixin.forEach (third_party/dart/sdk/lib/_internal/vm_shared/lib/compact_hash.dart:764:13) #12 PointerRouter._dispatchEventToRoutes (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/pointer_router.dart:141:18) #13 PointerRouter.route (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/pointer_router.dart:131:7) #14 GestureBinding.handleEvent (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:530:19) #15 GestureBinding.dispatchEvent (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:499:22) #16 RendererBinding.dispatchEvent (D:/Flutter/flutter_flutter/packages/flutter/rendering/binding.dart:473:11) #17 GestureBinding._handlePointerEventImmediately (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:437:7) #18 GestureBinding.handlePointerEvent (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:394:5) #19 GestureBinding._flushPointerEventQueue (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:341:7) #20 GestureBinding._handlePointerDataPacket (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:308:9) #21 GestureBinding._handlePointerDataPacket (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:300:3) #22 _invoke1 (lib/ui/hooks.dart:347:13) #23 PlatformDispatcher._dispatchPointerDataPacket (lib/ui/platform_dispatcher.dart:467:7) #24 _dispatchPointerDataPacket (lib/ui/hooks.dart:282:31) #25 _dispatchPointerDataPacket (lib/ui/hooks.dart:280:1) #26 stub InvokeDartCode0xd4符号化后可以清晰看到崩溃发生在main.dart的_MyHomePageState._dartFreeze方法具体行号第 41 行和第 44 行调用链完整从 Dart 层到 Flutter 框架再到 native 层split-debug-info 参数影响体积减少加上--split-debug-info参数后符号信息从app.so中分离应用体积略有减小。DevTools 无法连接DevTools 依赖符号文件进行调试。添加此参数后会导致 DevTools 无法连接应用。建议在 Release 模式下使用。性能无影响测试表明开启和关闭该参数对 UI 和 Raster 性能无明显影响。相关链接Flutter 官方文档: https://docs.flutter.dev/reference/flutter-cli