本原创文章帖发布在华为开发者联盟社区，欢迎开发者前往访问评论交流，更多与该内容相关讨论，请点击原帖查看：高效处理鸿蒙应用运维态FD资源泄漏-华为开发者话题 | 华为开发者联盟
概述
FD（全称：File Descriptor，文件描述符）资源泄漏是一种比较常见的泄漏类型，也是应用稳定性优化的重要问题。本文档主要介绍在运维态下如何通过应用质量管理（ APMS ） 平台进行 FD 资源泄漏的监控、分析、定位与修复整套处理方法。
运维态 FD 资源泄漏分析流程
标准化排查流程
整体流程图
排查步骤
1. 故障预警配置：在 APMS 平台配置 FD 泄漏监控告警规则，设置监控时段、频率和触发条件。
2. 问题发现与筛选：通过故障预警或主动分析页面，筛选 FD_LEAK 类型的泄漏问题。
3. 关键信息提取：分析故障模块、发生次数、影响设备数等关键信息，定位高优问题。
4. 根因定位：通过证据链、持有链分布和现场数据，深入分析泄漏原因。
5. 修复与验证：根据修复建议优化代码，并验证修复效果，形成闭环。
指标监控与关键信息提取
资源泄漏监控信息详情
故障分析表格会将相同根因类型的故障聚类并排序。表格会展示故障模块、发生次数（占比）、影响设备数（占比）等关键信息，开发者可以通过发生占比和故障模块结合业务实际情况找出高优的问题，并在问题状态和优先级这一栏做出标记，优先解决高优先级的问题。
如下图所示，页面入口：故障分析->资源泄漏->资源泄漏信息详情。
关键指标说明
• 问题特征 ID：故障模块的哈希值，同类故障模块会聚类到一起。
• 故障模块：发生泄漏的模块或组件，用于定位问题范围。
• 发生次数（占比）：泄漏问题发生的频率，帮助判断问题严重程度。
• 影响设备数（占比）：受影响的设备数量，评估问题影响面。
• 最大泄漏数：单次泄漏的最大句柄数。
故障详情页面介绍
通过点击查看按钮，进入到故障详情页面。
故障详情页面可以通过证据链、现场数据、句柄栈信息进一步深入分析泄漏的原因。
证据链
证据链列表根据泄漏数量的大小排序，优先查看泄漏数量最大的句柄名称。
现场数据
现场数据展示了当前 FD 泄漏的 Top10 的句柄名称，可结合代码、日志分析对应的 FD 泄漏对象。
句柄栈信息
句柄栈信息中可查看对应的堆栈信息，以及疑似泄漏点。
APMS 平台 FD 泄漏分析案例
灰度任务创建
应用灰度特性是一种运维态功能，用于精准采集故障日志。开发者在端侧集成应用灰度采集功能（可参考：应用灰度采集介绍 ）后，该应用可参与应用灰度活动。通过云端平台进行灰度采集 ，可圈选部分设备开启故障日志精准采集，帮助开发者快速定位故障。
APMS 故障预警
在故障预警平台的告警规则页面新建 FD 泄漏告警。根据实际的业务情况，选择合适监控时段、监控频率、告警触发条件以及其他告警指标，其中 FD 泄漏对应的指标类型为 FD_LEAK。
创建告警之后，后台会开始收集数据。当达到设置的告警阈值后，会触发故障预警。
问题查看与聚类
聚类规则说明
FD 资源泄漏聚类规则请参考句柄泄漏聚类规则 。
问题查看
• Top 问题查看
通过故障告警的指引，在故障分析页面筛选出 FD_LEAK 的泄漏类型。
点击查看按钮，即可跳转到 Top 问题查看页签下的 FD 资源泄漏问题列表。
• 资源泄漏信息详情 Top 问题
在左侧页面 APMS 菜单下的故障分析菜单中，在资源泄漏页签下选择泄漏类型为 FD_LEAK，点击查询按钮，过滤出此应用的 FD 资源泄漏问题。
在资源泄漏信息详情中，可查看当前应用的 FD 资源泄漏情况。
根因定位与分析
过滤出 FD 资源泄漏故障列表后，点击查看按钮，进入到问题个例分析详情页，可查看当前故障的分析报告，包含故障发生时间、泄漏句柄、故障模块、版本信息以及修复建议等。
证据链分析
证据链列表中按照泄漏数量倒序排序，将 FD 泄漏的句柄名称展示出来，开发者可根据泄漏数量较大的句柄名称，结合代码分析 FD 泄漏根因。同时提供了日志下载功能，便于进一步分析。
现场数据分析
现场数据页中，将展示 Top10 的泄漏句柄名称，开发者根据泄漏数量较大的句柄名称，并结合代码分析 FD 泄漏根因。
句柄栈信息分析
句柄栈信息是发生 FD 泄漏故障并达到一定条件后，系统从堆栈中抓取的堆栈信息，存在一定的滞后性。开发者可参考堆栈中的疑似泄漏点，进行堆栈还原后，结合代码分析具体的 FD 泄漏根因，并进行修复。
下钻分析
下钻分析的核心逻辑是从一个汇总的指标或表象问题出发，将其拆分成多个组成部分，然后挑出最关键的线索继续向下拆分，不断重复这个过程，直到定位到具体的根因。平台会根据故障特征 ID 进行聚类并筛选 Top 应用版本，系统版本以及设备型号。开发者可根据此重点关注问题高发的版本及设备，更精确的定位问题。
修复建议验证与闭环
修复建议
故障详情页面会提供修复建议，开发者可以通过给出的建议优化代码。
一般来说，开发者需要根据引用链尝试定位并断开应用侧的引用链路，释放对应的可疑泄漏对象。
问题修复与闭环
• 问题修改
开发者根据修改建议，在工程中释放 FD 泄漏对象。
• 问题标记
优化之后，可以在分析页面对对应的 FD 泄漏对象标记。
• 应用发布
应用发布之后，更新平台告警规则，并持续关注新版本的 FD 资源泄漏数据。对比修复前后的问题发生率，确认修复是否有效。
基于 Operation Analyzer 平台分析
Operation Analyzer 平台是指 DevEco Studio 的 Operation Analyzer 插件，通过该插件查看到应用对应的故障数据，数据和 APMS 平台上一致，开发者使用该插件以相同的方式分析运维态的泄漏问题。
Operation Analyzer 平台入口
打开 DevEco Studio 后，在 Tool Windows 栏的 Operation Analyzer 进入平台，点击后根据包名选择应用，再点击资源泄漏（Resource Leak）即可查看该类故障相关数据。
问题分析
证据链分析
证据链列表中按照泄漏数量排序，将 FD 泄漏的句柄名称展示出来，开发者可根据泄漏数量较大的句柄名称，结合代码分析 FD 泄漏根因。
现场数据分析
现场数据页面将展示 Top10 的泄漏句柄名称，开发者根据泄漏数量较大的句柄名称，并结合代码分析 FD 泄漏根因。
句柄栈信息分析
句柄栈信息中将抓取的堆栈信息中疑似泄漏点进行展示，开发者进行堆栈还原后，结合代码分析具体的 FD 泄漏根因，并进行修复。
🔗 官网开发者学堂视频：https://developer.huawei.com/consumer/cn/training/result?type2List=201783644516849879&orderBy=1&courseType=5
🔗 社区 DFX 专题文章： https://developer.huawei.com/consumer/cn/forum/subject/2101218731402391001
【扫码加入 HarmonyOS DFX 技术交流群】
