案例：ArkTS内存泄漏分析
==============

本案例介绍如何判断应用存在ArkTS内存泄漏，以及如何通过快照对比找出ArkTS内存泄漏的原因。

#### 初步识别内存问题

1.  使用[实时监控功能](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/realtime-monitor)对应用的内存资源进行监控。正常操作应用，观察运行过程中Memory泳道的变化。
    
    当在一段时间内应用内存没有明显增加或者在内存上涨后又逐渐回落至正常水平，则基本可以排除应用存在内存问题；反之，在一段时间内不断上涨且无回落或者内存占用明显增长超出预期，那么则可初步判断应用可能存在内存问题。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/70/v3/ZGB9nk9BSROko4Ca_Qulxw/zh-cn_image_0000002624994257.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=CF5BE11BA1C483B61D4646D45F20CD2FC81B04423B062A1B133649AC92C3C633 "点击放大")
    
2.  当从实时监控页面初步判断应用可能存在内存问题后，通过[深度录制](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/deep-recording)抓取应用内存在问题场景下的详细数据，初步定界问题出现的位置。Memory泳道存在Allocation或Snapshot模板中，使用Allocation或Snapshot模板录制均可。
3.  以Allocation模板为例，创建模板后，将模板中的其余泳道去除勾选，仅录制Memory泳道的数据。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c1/v3/BSia4LsTRz-05x5JUhuvYA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=D732B36D0803FB5633CB60A6DDF34899091547BFC019C4968FD4BB6BA728F5A5)
    
    其余泳道会抓取内存分配、内存对象等数据，为避免额外开销和影响分析，建议先排除录制。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b7/v3/fWvnk0jMRCeajG5ZnTnvhQ/zh-cn_image_0000002625074399.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=DDB8CEBC84412D4D8F1F501C09ABF357AA2F1C8118673D10DA027BA3113A5E23)
    
4.  点击三角按钮![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c/v3/9uc_6dG1SiSZZM1anOiCFg/zh-cn_image_0000002625074407.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=434B9400027AA0704839D07D451EA14368310E2E3AEA1EEA469A85A901E9ED1A "点击放大")即开始录制。
5.  录制过程中，不断操作应用在问题场景的功能，将问题放大，便于快速定界问题点。
6.  点击下图中方块按钮或者左侧停止按钮结束录制。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/74/v3/U29wIgDrS8e6R2iEm-jsew/zh-cn_image_0000002625074409.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=EB608ACF6C9D202E41CEDEA009727FEC5A5CE74E483014A2E8B8372232AA5D45 "点击放大")
    
7.  录制完成后，展开Memory泳道，其中ArkTS Heap表示方舟虚拟机内存，这部分内存受到方舟虚拟机的管控。当ArkTS Heap有明显的上涨，说明在方舟虚拟机内的堆内存上可能存在内存泄漏，可以使用Snapshot模板进行下一步分析。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/14/v3/votwEm8YR0yii_77y1AqDg/zh-cn_image_0000002624994263.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=8CDA2EF66446201000E5CFB035E0A91584D05F3479219A39311FCDDB2A6582E0 "点击放大")
    

#### 使用Snapshot模板分析ArkTS内存问题

分析内存泄漏问题步骤如下：

1.  使用Snapshot模板录制数据；
2.  在问题场景前拍摄快照；
3.  触发问题场景后，再次拍摄快照；
4.  对比两次快照的数据，可快速找到泄漏对象并做进一步分析；
5.  当有多个对象在比较视图都存在时，可以重复多次触发问题场景后拍摄快照，分别和问题场景前拍摄的快照进行对比，观察是否有对象出现明显的线性变化趋势，进一步缩小泄漏对象的范围。

#### \[h2\]录制模板数据

1.  连接设备后启动应用，点击应用选择框选择需要录制的应用，选择**Snapshot**模板，点击Create Session或双击Snapshot图标即可创建一个Snapshot的录制模板。
2.  创建模板后，点击三角按钮即开始录制。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e1/v3/HxYzq8gpTnW8CeMoEPYOGg/zh-cn_image_0000002625074403.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=B92A0B5708313628BCB85345BB89E66BFADA7C8EA3B0AFD440D2E4D85FDC219D "点击放大")
    
3.  待右侧泳道全部显示recording后则表明正在录制中。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/88/v3/6Uh7BZZmQPeAExmwxiUlbQ/zh-cn_image_0000002624994269.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=656930FF9BDF3CC42F4A2DCD54205CECECED7D15616D4346C5E2F969D2AA66C1 "点击放大")
    
4.  拍摄第一次堆快照作为基准（点击图中①处拍摄按钮，待②处显示出紫色条块表示快照拍摄完成）。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/db/v3/FW8qJUC3Qb2X3euDZ5rGiw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=F84AE5331112D93CECD5347AD41C1F15711D5474EC7058934598BB0264DD4EFC)
    
    方舟虚拟机提供了在获取快照前自动GC（Garbage Collection，对堆内存进行垃圾回收）的能力，因此拍摄快照之前不用主动触发GC。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2b/v3/GevJwrqwQOSvv9Tk_AKFaA/zh-cn_image_0000002624994265.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=9CAF62732AC56C773D33726C83096A0B020C05235A767D7C22C909EC75A9446C "点击放大")
    
5.  多次触发内存泄漏操作。可以操作5，7，11等这种特殊的次数。比如操作了5次对比两个快照发现有很多创建了5次没释放的场景，则可能存在内存泄漏，再操作7次，如果创建了7次那就可以确认发生了泄漏。
6.  拍摄第二次堆快照。
7.  点击下图中方块按钮或者左侧停止按钮结束录制。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a7/v3/6M0QFzwDTUGvFZrg7cz2Fw/zh-cn_image_0000002625074411.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=538FE0F17AAEBFAFAE565F520D3B49B99FB28F920C24899486B882EF45288B34 "点击放大")
    

#### \[h2\]分析ArkTS Heap

1.  在每次拍摄堆快照之前，虚拟机都会触发GC，所以理论上堆快照内存在的对象都是当前虚拟机已经无法GC掉的对象。我们可以将两个堆快照进行比较，来查看哪些对象是在触发问题场景时新增了且不能释放的。切换到窗口下方详情区域的**Comparison**区域，将两次快照进行对比。图中数据的含义是以Snapshot2作为基准，Snapshot2对比Snapshot1的数据变化量。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c1/v3/AIx49rJfRW6PU-jS4Iavig/zh-cn_image_0000002594474912.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=8379983BF5CFEE587703001AA051EE91D934EA79DE9E63C3D0792AA575B4A844 "点击放大")
    
2.  优先寻找与触发内存泄漏操作次数强相关、与业务代码强相关的Constructor，首先来分析这些对象是否正常。主要是按照Distance逐渐减小的方式找引用链，可以从references里面一层层去寻找，排查引用链上的可疑对象（一般指与业务代码关联的对象）。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/78/v3/PV6_u8eHR1SxTadJ05EjoQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=47433E038260202B91F1F3EB0B5C26D966F1016C6B721564572BFBFE74732499)
    
    选择一个实例节点，系统会计算从GC Roots到选定对象的最短路径，并在右侧Shortest Paths页签实时切换和展示。
    

#### 分析Snapshot数据

#### \[h2\]常见对象介绍

**JSArray**

目前所有JSArray展开后为数组里的各个元素：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f3/v3/GI8mG3jhQ3SVBTOb17x_fA/zh-cn_image_0000002625074395.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=85A3CA27A31867AF4EEEE1E799210D383EB40450ED4BFE352D445A1F464389E2)

其中\_\_proto\_\_：原型对象，所有数组的\_\_proto\_\_应该是一致的；length：内置属性访问器，可以访问数组长度。

**TaggedDict**

位于(array)标签中，一般为虚拟机内部创建的字典，ArkTS代码层面不可见。

**TaggedArray**

位于(array)标签中，一般为虚拟机内部创建的数组，ArkTS代码层面不可见。

**COWArray**

位于(array)标签中，一般为虚拟机内部创建的数组，ArkTS代码层面不可见。

**JSObject**

JSObject展开后为内部的各个属性如下：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/44/v3/zrvoQG-EQVS68ajjHkkHMA/zh-cn_image_0000002624994255.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=DE3CB134C6958259AA5A19D9E82C65A505F321BB2635C45119F188425F771889)

以下通过具体代码来介绍下实例化对象、声明对象、构造函数间的关系：

// HelloWorldPage.ets
class People {
  old: number
  name: string
  constructor(old: number, name: string) {
    this.old \= old;
    this.name \= name;
  }
  printOld() {
    console.log("old = ", this.old);
  }
  printName() {
    console.log("name = ", this.name);
  }
}

@Entry
@Component
struct HelloWorldPage {
  @State message: string \= 'Hello World';
  private people: People \= new People(20, "Tom");

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}

采集到的snapshot数据如下：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fe/v3/s7H3F4j0QGi9Ag2_-12qXw/zh-cn_image_0000002625074401.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=C5628AD647D38095CE138EF435222A8343D1DCE3F5E9400E3CFCDD0DF17F0A92)

202169对象对应的是People，其主要声明了对象的属性和方法。

实例化对象的\_\_proto\_\_属性指向声明时的对象，声明对象里则会有constructor构造函数。当实例化多个对象时，实例化对象会有多个，但是声明对象和构造函数只有一个。

**JSFunction**

目前所有JSFunction都在(closure)标签中，展开即可看到所有JSFunction：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/84/v3/TqF6sTPLQlSb56E7mXDTEg/zh-cn_image_0000002625074405.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=563DC1B82E8ED663D34B233A62626B0ADDE88568B3D8DF2CAF2F37500B820A40 "点击放大")

每个函数展开后为函数内的各个属性：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/54/v3/BJovdMNiTXiF4X6HDzduDg/zh-cn_image_0000002594634834.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=6F38FFB8B9ADF33073C5490EF4B83A49B38C2F1BE3C3CD0D295EDE81930CEC41)

其中HomeObject表示父类对象，即该方法属于哪个对象；\_proto\_表示原型对象；LexicalEnv表示该函数的闭包上下文；name是内置属性访问器，可获取函数名；FunctionExtraInfo表示额外信息，比如一些napi接口会在这里记录函数地址；ProtoOrHClass表示原型或者隐藏类。

如果函数显示为anonymous()，则表示为匿名函数；如果函数显示为JSFunction()，则表示该函数可能为框架层函数，创建函数的时候未设置函数名。对于这两种函数名不可见的情况，可以通过查看其引用来间接确认其名称：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6b/v3/ORY18d0YSrajzWP9L7gIQQ/zh-cn_image_0000002624994259.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=7556C36A053B43D1F90AE64F3B23EB9C9884766557435D65DC905CB9D4115E9A)

**ArkInternalConstantPool**

虚拟机创建的常量池，ArkTS代码层面不可见，涉及到的字符串常量会在(array)标签中展示：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e/v3/3u8zFULZSvu4lG4J_94Psw/zh-cn_image_0000002624994261.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=C9207F262879E960687D902562ED18D09CBDF8C4752557F52CBBE98AF1AC9556 "点击放大")

**LexicalEnv**

闭包变量上下文；闭包是一个链状结构，如下所示：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d1/v3/0dyK1Dd1QRuqzdtYA4nAHA/zh-cn_image_0000002625074397.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=846BE240C7CEB91FD881243A626475BF3AEFD23CF159F255060EDA7145BAD68A)

733这个节点本身是一个闭包数组，其中0号元素是调用者（或者再往上的调用者，以此类推）的闭包；1号元素存储的是调试信息；2号及以后的元素存储的就是闭包传递的变量，上例传递了一个变量。

**InternalAccessor**

内置属性访问器，会有getter和setter方法，通过getter、setter可以获取、设置该属性。

**LocalHandleRoot**

DevEco Studio 6.1.0 Release版本新增，位于(handle)标签中，用于管理JS对象生命周期的引用句柄（napi\_value）。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c8/v3/gZrYdBAHQ8mRtvejcMFEZg/zh-cn_image_0000002624994267.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=2D953FFF861767CFD46D25129C936FE3851331184D12BAC651B9732CC750B789)

**GlobalHandleRoot**

DevEco Studio 6.1.0 Release版本新增，位于(handle)标签中，允许用户管理ArkTS/JS值的生命周期的引用句柄（napi\_ref）。

**VMRoot**

26.0.0 Beta1版本新增，位于(handle)标签中，表示虚拟机层面的根节点。

**FrameRoot**

26.0.0 Beta1版本新增，位于(handle)标签中，表示函数调用栈帧在GC遍历过程中的根节点。

**SourceTextModule**

SourceTextModule为虚拟机创建的对象，当应用使用export暴露对象后会被SourceTextModule对象持有。

属性EcmaModuleRecordName表示export对象所在的文件名，属性EcmaModuleFileName表示export对象文件所在的abc文件名，这两个属性名在26.0.0 Beta1版本新增。如果快照用TRIM\_LEVEL\_2级别裁剪生成的.rawheap文件转换成的.heapsnapshot文件则不显示这两个属性名。

**Proxy-<对象实例名称>**

26.0.0 Beta1版本新增，被@Observed装饰的class实例，或被状态管理V1装饰器（如@State）装饰的对象实例，系统会自动在Proxy后带上对象实例名称。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/95/v3/QEQ7SlUzQsaN-bcdG2riQg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=538F0BC5F120EA4D6D9F259B77E77955ABD41481CF0E4E5BDA941F2D57F1D0E6)

若开启进程级堆快照转储以后，是由子线程触发的进程级堆快照转储将不会展示对象实例名称。

#### \[h2\]常见属性介绍

| 
属性

 | 

含义

 |
| :-- | :-- |
| 

\_\_proto\_\_

 | 

原型对象

 |
| 

(object elements)

 | 

对象元素

 |
| 

(object properties)

 | 

对象属性

 |
| 

hclass

 | 

隐藏类

 |
| 

ArkInternalHash

 | 

ArkTS运行时内部的哈希值

 |
| 

ProtoOrHClass

 | 

原型或隐藏类指针

 |
| 

RawProfileTypeInfo

 | 

运行时类型剖析信息

 |
| 

HomeObject

 | 

父类对象

 |
| 

FunctionKind

 | 

函数类型标识

 |
| 

FunctionExtraInfo

 | 

函数附加信息

 |
| 

prototype

 | 

构造函数或类对象关联的原型对象

 |
| 

Inlineproperty

 | 

内联属性

 |

#### \[h2\]分析方法

**查看对象名称**

对于声明对象，可以通过constructor属性来确定对象名称。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a0/v3/1usyNbWoQKGkg2IMWJszDg/zh-cn_image_0000002594474914.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=45550C7F85BDAF7D034AB322CA7C156BDF43C8467584A3450AD29691B91BBC2F)

对于实例化对象，一般没有constructor，则需要展开\_\_proto\_\_属性后查找constructor；

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fc/v3/Y29CGELWQrejUah7xEPoDg/zh-cn_image_0000002594474916.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=6E974392676987AC33F6BAF22557E669681E2DF63709B01ED5D2ED83687E0ECB)

若对象里有一些标志性属性，可以通过在代码里搜索属性名称来找到具体是哪个对象。

如果对象间有继承关系，则可以继续展开\_\_proto\_\_：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/60/v3/aWAJsTQDRWaRx1P_cIeyrg/zh-cn_image_0000002594634836.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=929714B62315FBFA8EE658E61AA9732403AFF02E58928C236F9E958D43C0FBCB)

如上图则表明Man对象继承自People对象。