【HarmonyOS Next】鸿蒙应用故障处理思路详解原创

George_wu_

发布于 2025-3-25 00:19

浏览

1收藏

【HarmonyOS Next】鸿蒙应用崩溃处理思路详解

一、崩溃问题发现后定位

1. 崩溃现象：
常见的崩溃问题表现为，应用操作后白屏闪退，或者应用显示无响应卡死。

2.定位问题：
发现崩溃后，我们首先需要了解复现步骤，精确定位复现步骤。因为提供复现步骤得人，可能是用户和测试，非开发人员，其中的步骤并非最短路径。

3.排查问题点
根据复现步骤，我们需要查看日志表现，鸿蒙的DevEco IDE提供了日志看板，根据HiLog和FaultLog，我们可以初步区分崩溃问题的类型。
【HarmonyOS Next】鸿蒙应用故障处理思路详解-鸿蒙开发者社区
根据日志看板的FaultLog，可以查看崩溃输出的

JS Crash，一般是ArkTS原生逻辑的崩溃
CppCrash，一般是NDK，C层的崩溃

JS Crash
点击进入JS Crash中，可以查看到崩溃信息，以下几种类型的错误：
【HarmonyOS Next】鸿蒙应用故障处理思路详解-鸿蒙开发者社区
可以根据JS Crash提示的错误行数，直接点击跳转到错误代码处，根据提示检查和修复问题。

Device info:xxx
Build info:xxx-xxx x.x.x.xxx(xxxx)
Fingerprint:a370fceb59011d96e41e97bda139b1851c911012ab8c386d1a2d63986d6d226d
Module name:com.xxx.xxX
Version:1.0.0
Versioncode:1000000
PreInstalled:No
Foreground:Yes
Pid:39185Uid:20020145
Reason:TypeError
Error name:TypeError
Error message:Cannot read property needRenderTranslate of undefined
Stacktrace:Cannot get SourceMap info, dump raw stack:at anonymous (entry/src/main/ets/pages/Index.ts:49:49)

1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.

this.translationUpY = (this,multiCardsNum >= 1)? sceneContainerSessionListlthis.multiCardsNum -、
1].needRenderTranslate.translateY :0
this.translationDownY = (this.multiCardsNum >= 2)? sceneContainerSessionList[this.multiCardsNum -
2].needRenderTranslate.translateY :0;
1.
2.
3.
4.

CppCrash
根据日志提示，检查是否有以下错误情况：
【HarmonyOS Next】鸿蒙应用故障处理思路详解-鸿蒙开发者社区

AppFreeze
一般是由于耗时操作，导致堵塞主线程。此时用户操作时，会触发无响应。一般分为以下三种情况，超时时间一般在6s左右。
【HarmonyOS Next】鸿蒙应用故障处理思路详解-鸿蒙开发者社区

内存泄漏
这种问题排查起来是最麻烦的，所以保持良好的代码编程规范，不需要的对象该释放释放，不用的句柄也需要释放。

一般碰到内存泄漏，根据提供的复现步骤，很多情况下是非必现。（如果是必现，那最好了，修复该问题会很快。）我们需要操作复现步骤，使用鸿蒙DevEco IDE的ProFiler工具：
【HarmonyOS Next】鸿蒙应用故障处理思路详解-鸿蒙开发者社区
检测应用操作时的内存使用情况。

二、问题解决，检查类似错误情况一起修复

1.根据章节一问题定位清楚后，根据错误具体情况，思考修复方案

2.根据问题情况，检查其他代码是否有同类问题，一起修复后验证。

3.根据官网提供的材料进行学习，编码过程中进行规范和排查：
【HarmonyOS Next】鸿蒙应用故障处理思路详解-鸿蒙开发者社区

性能优化举例：
业务场景是：点击跳转下一页，直接加载Web页面。这是大多数三方应用的实现方式，其实应该在后台创建一个ArkWeb组件来预先启动用于渲染的Web渲染进程。这样跳转到web页面的时间就不会那么长：

// 创建NodeController
// common.ets
import { UIContext } from '@kit.ArkUI';
import { webview } from '@kit.ArkWeb';
import { NodeController, BuilderNode, Size, FrameNode } from '@kit.ArkUI';

// @Builder中为动态组件的具体组件内容
// Data为入参封装类
class Data {
  url: string = 'https://www.example.com';
  controller: WebviewController = new webview.WebviewController();
}

@Builder
function webBuilder(data: Data) {
  Column() {
    Web({ src: data.url, controller: data.controller })
      .domStorageAccess(true)
      .zoomAccess(true)
      .fileAccess(true)
      .mixedMode(MixedMode.All)
      .width('100%')
      .height('100%')
      .onPageEnd((event) => {
        // 输出Web页面加载完成时间
        console.info(`load page end time: ${Date.now()}`);
      })
  }
}

let wrap = wrapBuilder<Data[]>(webBuilder);

// 用于控制和反馈对应的NodeContainer上的节点的行为，需要与NodeContainer一起使用
export class MyNodeController extends NodeController {
  private rootnode: BuilderNode<Data[]> | null = null;
  private root: FrameNode | null = null;
  private rootWebviewController: webview.WebviewController | null = null;

  // 必须要重写的方法，用于构建节点数、返回节点挂载在对应NodeContainer中
  // 在对应NodeContainer创建的时候调用、或者通过rebuild方法调用刷新
  makeNode(uiContext: UIContext): FrameNode | null {
    console.info(' uicontext is undefined : ' + (uiContext === undefined));
    if (this.rootnode != null) {
      const parent = this.rootnode.getFrameNode()?.getParent();
      if (parent) {
        console.info(JSON.stringify(parent.getInspectorInfo()));
        parent.removeChild(this.rootnode.getFrameNode());
        this.root = null;
      }
      this.root = new FrameNode(uiContext);
      this.root.appendChild(this.rootnode.getFrameNode());
      // 返回FrameNode节点
      return this.root;
    }
    // 返回null控制动态组件脱离绑定节点
    return null;
  }

  // 当布局大小发生变化时进行回调
  aboutToResize(size: Size) {
    console.info('aboutToResize width : ' + size.width + ' height : ' + size.height);
  }

  // 当controller对应的NodeContainer在Appear的时候进行回调
  aboutToAppear() {
    console.info('aboutToAppear');
  }

  // 当controller对应的NodeContainer在Disappear的时候进行回调
  aboutToDisappear() {
    console.info('aboutToDisappear');
  }

  // 此函数为自定义函数，可作为初始化函数使用
  // 通过UIContext初始化BuilderNode，再通过BuilderNode中的build接口初始化@Builder中的内容
  initWeb(url: string, uiContext: UIContext, control: WebviewController) {
    if (this.rootnode != null) {
      return;
    }
    // 绑定预创建的WebviewController
    this.rootWebviewController = control;
    // 创建节点，需要uiContext
    this.rootnode = new BuilderNode(uiContext);
    // 创建动态Web组件
    this.rootnode.build(wrap, { url: url, controller: control });
  }

  // 此函数为自定义函数，可作为初始化函数使用
  loadUrl(url: string) {
    if (this.rootWebviewController !== null) {
      // 复用预创建组件，重新加载url
      this.rootWebviewController.loadUrl(url);
    }
  }
}

// 创建Map保存所需要的NodeController
let NodeMap: Map<string, MyNodeController | undefined> = new Map();
// 创建Map保存所需要的WebViewController
let controllerMap: Map<string, WebviewController | undefined> = new Map();

// 初始化需要UIContext 需在Ability获取
export const createNWeb = (url: string, uiContext: UIContext) => {
  // 创建NodeController
  let baseNode = new MyNodeController();
  let controller = new webview.WebviewController();
  // 初始化自定义web组件
  baseNode.initWeb(url, uiContext, controller);
  controllerMap.set(url, controller);
  NodeMap.set(url, baseNode);
};

// 自定义获取NodeController接口
export const getNWeb = (url: string): MyNodeController | undefined => {
  // 加载新的Url时，建议复用预创建的Web组件
  if (!NodeMap.get(url) && NodeMap.get('about://blank')) {
    // 获取预创建的Web组件
    let webNode = NodeMap.get('about://blank') as MyNodeController;
    // 重新加载url
    webNode.loadUrl(url);
    return webNode;
  }
  return NodeMap.get(url);
};
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
86.
87.
88.
89.
90.
91.
92.
93.
94.
95.
96.
97.
98.
99.
100.
101.
102.
103.
104.
105.
106.
107.
108.
109.
110.
111.
112.
113.
114.
115.
116.
117.
118.
119.
120.
121.
122.
123.
124.