文档开发者中心
我的
|

HarmonyOS 6

DFX

ArkTS内存快照聚类分析规则

一、聚类需求背景

       在通过ArkTS内存快照定位内存泄漏问题时,通常需要优先关注内存占用大的对象,这部分对象在快照中占比比较大。当数量较多时,存在不同调用点创建的对象因为对象类型被归类在同一目录下,如jsobject/jsarray等对象,在大型工程中一般情况下拥有10万以上的数量级,无法通过人工来快速识别同类型不同业务对象各自占用的内存大小。因此,需要聚类规则来指导针对快照的聚类分析,将快照中的同类对象进行聚类,从而统计出各泄漏对象的影响大小,对定位内存泄漏问题有着关键性的指导作用。

二、聚类步骤描述

       1. 确认聚类锚点,只聚类top20的目录下的对象并且retained size占在5%以上的目录下的对象;

       2. 通过聚类规则对各类对象进行聚类。为了保证聚类结果的有效性,不同的目录下存放的对象不同,聚类规则也不同;

       3. 统计各类对象的数量及内存占用大小,能够按照对象的数量或内存大小进行排序。

三、聚类规则

       聚类规则主要分为三种:最短引用链聚类,名称聚类,属性聚类。不同的对象需要使用不同的聚类方法。

       注:建议所有对象默认按照最短引用链聚类。

1. 最短引用链聚类(基本类型对象默认按照最短引用链聚类)

       默认适用对象类型:Method,js_set,js_map,string,JSNativePointer,jsarray等

       Method,js_set,Map,string,JSNativePointer等目录下对象,优先通过引用链聚类。该类对象目录下名称一致,通过引用链可以区分对象创建场景。对比目录下各对象到GC ROOT的最短引用链(如果有多条最短引用链则选择retained size最大的那条引用链),最短引用链相同,则视为一类。

2. 名字 + 引用链聚类

       适用对象类型:Function ,framework,(array),各类业务对象(业务侧创建的类对象和函数对象)

       业务对象带有路径对象名称和行号信息。相同的类或函数对象调用点不同,则引用链不同,需要根据不同的调用点进行区分。

3. 属性+引用链聚类

       适用对象类型:jsobject,js_shared_object

       jsobject(js_shared_object)目录下对象名字相同,但代表的对象并不一致,需要通过引用链对jsobject对象进行分类,即对不同调用点的jsobject进行区分。

       jsobject对象中存在大量distance为1的对象,这些对象无法通过引用链区分,但可以通过属性进行区分,即直接持有的对象是否一致,如果jsobject对象直接持有的对象名称都相同,且持有关系(紫色的字代表持有关系)也相同,则归为一类。

4.特殊聚类

4.1 无需聚类对象类型

       适用对象:SourceTextModule, HiddenClass(NonMovable), global_env, global_object

       SourceTextModule对象是系统侧创建的,用于持有export对象。每个ts文件会对应生成一个SourceTextModule对象,持有该ts文件中export的对象,因此天然就已经是聚类后的结果,不需要再次聚类。

HiddenClass和其他对象是1对多的关系,每一个对象都持有一个HiddenClass对象的引用,因此每一个HiddenClass都是一类。

       GlobalEnv和GlobalObject在一份快照中是唯一的,因此也无需聚类。

4.2 异步任务相关对象

       适用对象:Promise/PromiseRecord/PromiseCapability/PromiseReaction

       异步相关的对象,请根据PromiseReaction下的handle信息+最短引用链进行聚类。Promise/PromiseRecord/PromiseCapability 对象为异步任务内部对象,开发者无需关注。PromiseReaction下的handle信息代表了该异步任务的下一跳任务,可以通过下一跳任务进行区分。

 4.3 proxy

       proxy往往与框架对象强相关,可以通过proxy下的target信息(handle)+引用链进行聚类。proxy下的target信息代表了proxy持有的被代理对象,proxy本身无意义,需要根据被proxy代理的对象进行区分。

点赞
4
收藏
3
回复
5
分享
举报
浏览4946 编辑于2026-07-20 03:10北京
全部评论
最多点赞
最新发布
最早发布
学了
3楼回复于2026-08-27 12:09 来自河南
请问,能否提供优化前后的应用示例代码
2
2楼回复于2026-08-27 07:45 来自江苏
好文
1楼回复于2026-07-07 05:29 来自北京
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

目录 收起
一、聚类需求背景
二、聚类步骤描述
三、聚类规则
1. 最短引用链聚类(基本类型对象默认按照最短引用链聚类)
2. 名字 + 引用链聚类
3. 属性+引用链聚类
4.特殊聚类
4.2 异步任务相关对象
4.3 proxy
鸿蒙应用问题定位定界(DFX)专题
01

Native泄漏排查定位手册

02

ArkTS组件内存泄漏排查定位手册

03

高效解决ArkTS与Native交互内存泄漏

04

资源泄漏别躲了,HiDebug 来抓现行

05

打破语言屏障,内存泄漏一“栈”到底

06

如何避免 napi_value 悬挂指针问题

07

SIGABRT 进程主动终止故障模式详解

08

HWASAN + BinXO踩内存分析工具

09

minidump:给崩溃分析装上高清摄像头

10

资源泄漏采集开发实践

11

增强采样栈,让应用冻屏无处遁形

12

采样栈定位主线程卡顿根因

13

采样栈定位主线程超时问题

14

采样栈定位全局锁主线程等待问题

15

高效处理运维态FD资源泄漏

16

快速定位开发态崩溃问题

17

Native崩溃的AI辅助定位

18

高效处理运维态GPU内核泄漏

19

应用冻屏AI 辅助定位

20

mem-analyzer采集&分析工具指导

21

ArkTS内存快照聚类分析规则

22

JSLeakWatcher特性指导

23

资源采集API特性指导

24

应用退出不知道原因?HarmonyOS有账本

25

使用冻屏增强日志定位繁忙类问题

26

开发态快速定位ArkTS泄漏

27

使用GWP-ASan定位地址越界问题

28

稳定性故障AI诊断能力

29

NAPI异步任务内存泄漏问题解决方案

30

运维态高效处理应用冻屏

31

运维态高效处理ArkTS泄漏

32

运维态高效处理应用崩溃

33

运维态高效处理Native泄漏

34

开发态快速定位Native泄漏

35

开发态快速定位DMA(ION)泄漏

36

开发态快速定位Freeze

37

堆栈痕迹反推根因,解决卡死问题

38

破译崩溃密码,让崩溃故障精准归因

39

一键读懂 ArkTS 内存泄露

40

参数访问undefined类JSCrash问题分析

41

SIGSEGV MAPERR 无效内存访问故障模式详解

42

快速配置你的线上预警

43

多维度量你的应用健康

44

快速定位线上崩溃根因

45

崩溃问题定位分析指导

46

JSLeakWatcher解决HarmonyOS内存泄漏难题

了解社区公约,与您携手共创和谐专业的开发者社区。