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

本案例介绍如何判断应用存在Native内存泄漏。

[6.1.0(23) Beta1](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/overview-610#section174491130173414)以下版本，通过Native Allocation泳道找出Native内存泄漏的原因。

[6.1.0(23) Beta1](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/overview-610#section174491130173414)及以上版本，通过All Heap泳道找出Native内存泄漏的原因。

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

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/9e/v3/E1KLpQOxTY62uzxaazyETg/zh-cn_image_0000002594634198.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=0123519AE74933D20EB5B0DACFBCEC9CF166CE81918DA84FB717D8FB083AFB40 "点击放大")
    
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/ed/v3/EL9HRfyeTAGyl03-WaTURA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=B0F72DFC25E4BA7F1DDF552DC4FDCD7DD0F6A3FD720CA62A2468932040DBD21F)
    
    其余泳道会抓取内存分配、内存对象等数据，为避免额外开销和影响分析，建议先排除录制。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/50/v3/HI8fQx1eSIO3wbJhf3Qffg/zh-cn_image_0000002594474290.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=E721676E63CA3E6949289813C4C055F94AB29BDF7DC19591DDADD8F152C807A4)
    
4.  点击三角按钮![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3b/v3/QwlpC8icRLqlyfTS79OruQ/zh-cn_image_0000002625073791.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=DFB0EC484661D82E486E74C8EAAA62E045DF738F433436E5D124DBC6B9F0A6EA "点击放大")即开始录制。
5.  录制过程中，不断在问题场景操作应用功能，放大问题便于快速定界问题点。
6.  点击下图中方块按钮或者左侧停止按钮结束录制。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/62/v3/EraDYxQeQTetCaq7fyNroA/zh-cn_image_0000002594634202.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=F0DFCD69B101D8D4786147DF8BF5821C2B8AF632098A6A9578F80652EAC776AA "点击放大")
    
7.  录制完成后，展开Memory泳道，其中Native Heap表示Native内存，主要是应用使用到的一些涉及Native API所申请的内存以及开发者自己的Native代码所申请使用的堆内存（通常是C/C++），这部分内存需要开发者自行管理申请和释放。
    
    当Native Heap有明显的上涨，说明Native内存上可能存在内存泄漏，可以使用[Allocation模板](#section776643810160)进行下一步分析。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/86/v3/g8CRjMzdR5OVxBejOHlHVA/zh-cn_image_0000002625073793.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=FFBFC2DB4B9BBB74CB94CC322548337A76F315859F3080DD29A08E61BB407F11 "点击放大")
    

#### 使用Allocation模板分析Native内存问题（DevEco Studio 6.1.0 Beta1及以上版本）

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

1.  连接设备后，点击应用选择框选择需要录制的应用，选择**Allocation**模板，点击Create Session或双击Allocation图标即可创建一个Allocation的录制模板。
2.  创建模板后，点击三角按钮即开始录制。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/63/v3/UmiD0dxzThSFtdhERxOIAg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=FB86E52D4E13AB432A3701A5047838DEBE754EE60180D891B70B39ED3D7580C0)
    
    如果要分析启动内存，单击Allocation任务后的![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/12/v3/La7QRzFnRsOfrvNur0OC9w/zh-cn_image_0000002594474278.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=750C8FFF3229BC967B2EB54E500217A3D962DD3B644A5EFF06FA48394068F222 "点击放大")按钮。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/01/v3/_74I-xZGRfKAzsAFTyVgig/zh-cn_image_0000002624993631.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=B25F0B361047D35CC78ED0B8CBD1CD343B82EE7B4304F4AEE99FF7C5868793FA "点击放大")
    
3.  操作应用复现问题场景，并在问题复现完成后，点击下图中方块按钮或者左侧停止按钮结束录制。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8a/v3/Sd1K43HvRHGKfLlNgFi9Vw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=B1E4196C2B4E80314561BFF22914E21EA7FC14AD521581439FE8101077A6D1C4)
    
    默认使用统计模式采集数据。该模式下工具的采集性能更好、负载更低。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3b/v3/XHq1nXBzTO2cFjigT9GlFw/zh-cn_image_0000002594634204.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=5CA65DADDA295FA4483997510DDDF45BAFCB71DF0EB2BE9E9CF442B255F0ED28 "点击放大")
    

#### \[h2\]分析Native数据

1.  框选All Heap中的Native Heap子泳道。

2.  在下方详情区的“Statistics”页签中选择Created & Existing。
    
    *   All Allocations：框选的时间段的所有分配内存信息。
    *   Created & Existing：默认选中，在框选范围的起点之后分配的，且在框选范围的终点之前没有释放的内存数据。
    *   Created & Released：在框选范围的起点之后分配的，且在框选范围的终点之前已经释放的内存数据。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/79/v3/kOmNtWbPQ1aQk76olosOHw/zh-cn_image_0000002624993633.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=9099710599D96C2A2CD89C9004E76792CDE98214D36632AA76551C6DD673D728 "点击放大")
    
3.  切换到“Call Trees”页签，该部分数据展示了详细的内存分配栈信息。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a5/v3/rASuzMz0SZC0CREPimZoCg/zh-cn_image_0000002625073787.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=0D056E3545EE5FBACE0097E9AC81CE55BD772717FE27AF10986ADDE90900449B "点击放大")
    
4.  优先在内存分配栈信息中寻找与业务代码强相关的Symbol Name，即Category中为亮色。从上图中看，主要泄漏点在业务代码侧，需要结合业务代码进行分析。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a3/v3/I1ycuY-cQSONAnRCPum8ow/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=77685FE8D1B01C9E181D4A34F385918A4DDEBDDF575AB1827A418FDAC09AB280)
    
    *   Category中亮色代表开发者调用栈，灰色代表系统调用栈。
    *   栈帧中主要为Native栈，为便于开发者分析Native的函数热点，工具提供了符号导入的能力，若需要查看这部分信息，需要导入相应版本的带符号的so库（具体参考[离线符号解析](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-profiler-data#section11376118192614)）。
    

#### 使用Allocation模板分析Native内存问题（DevEco Studio 6.1.0 Beta1以下版本）

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

1.  连接设备后，点击应用选择框选择需要录制的应用，选择**Allocation**模板，点击Create Session或双击Allocation图标即可创建一个Allocation的录制模板。
2.  创建模板后，点击三角按钮即开始录制。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/43/v3/u4piwFh8QJSRYFDh3n6ktg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=D9773613CC3DB91CBC372E83D32A0B79FA8DC18CC527DD21FC6A6F8D099C45F1)
    
    如果要分析启动内存，单击Allocation任务后的![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9/v3/AFMBRFo4RPmuPhkIuN8gOA/zh-cn_image_0000002594634196.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=E3B710A0FA210BB9E6109AA20E4AD70BBD280784D9BA616E94045CD9754557B9 "点击放大")按钮。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c/v3/hhS2rNE8S7iFlbwe-3YInQ/zh-cn_image_0000002625073779.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=01468A5D2F8FAF8C2DCC08AE083DFD1A226D5FD72CB76EBF71AD29D5CA55FBBE "点击放大")
    
3.  操作应用复现问题场景，并在问题复现完成后，点击下图中方块按钮或者左侧停止按钮结束录制。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/63/v3/vp1TWmMrRWiXTY-nJr2TjQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=0B2495B617733D4DEB33E262812C8EDC38AFC47A60FF5832616E4D6667F11DEC)
    
    默认使用统计模式采集数据。该模式下工具的采集性能更好、负载更低。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9e/v3/jr8s8NncQ8GpeTa-HHCazA/zh-cn_image_0000002625073777.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=8BE00E5766D538A884AC00311090519D84A0373D7834C9C3CCE336E524DA619E "点击放大")
    

#### \[h2\]分析Native数据

1.  框选Native Allocation泳道或子泳道。两个子泳道All Heap和All Anonymous VM分别代表使用malloc和mmap函数分配的内存情况。

2.  在下方详情区的“Statistics”页签中选择Created & Existing。
    
    *   All Allocations：框选的时间段的所有分配内存信息。
    *   Created & Existing：在框选范围的起点之后分配的，且在框选范围的终点之前没有释放的内存数据。
    *   Created & Released：在框选范围的起点之后分配的，且在框选范围的终点之前已经释放的内存数据。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/45/v3/tNwcBY8ZSGyfrdy54vcOhQ/zh-cn_image_0000002594474284.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=6A831788D9F4F98D104F0C750ED2E9018E796A6F07034DBDBB2E5DC51770CD66 "点击放大")
    
3.  切换到“Call Trees”页签，该部分数据展示了详细的内存分配栈信息，同样需要选择Created & Existing。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/48/v3/NeahTbVaQSKwLzpf2F_8OA/zh-cn_image_0000002625073783.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=E65CE3D7E0F630117C852FAAAFF6A5B351F8F7D7800EA2C356FD35499284589E "点击放大")
    
4.  优先在内存分配栈信息中寻找与业务代码强相关的Symbol Name，即Category中为亮色。从上图中看，主要泄漏点在业务代码侧，需要结合业务代码进行分析。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/78/v3/ewVXYuVTSLyiv8CW9WSt5A/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073913Z&HW-CC-Expire=86400&HW-CC-Sign=1475D7FBF0788026F754DE16AE6A200A7AF93444196C8D0493A49F77AB51C8A8)
    
    *   Category中亮色代表开发者调用栈，灰色代表系统调用栈。
    *   栈帧中主要为 Native 栈，除了应用本身编译的一些so及带有部分接口信息的so信息外，其他系统库部分仅展示so库与函数偏移信息，若需要查看这部分信息，需要导入相应版本的带符号的 so 库（具体参考[离线符号解析](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-profiler-data#section11376118192614)）。