HarmonyOS开发常见问题及解答（三）

本原创文章帖发布在华为开发者联盟社区，欢迎开发者前往访问评论交流，更多与该内容相关讨论，请点击原帖查看：HarmonyOS开发常见问题及解答（三）-华为开发者话题 | 华为开发者联盟

FAQ 1：混淆导致的鸿蒙云调试闪退问题如何解决？

【问题场景】：鸿蒙云调试闪退，模拟器正常运行，日志显示 proxy SendRequest 失败，

【解决方案】：开启混淆后导致云调试应用 jscrash，关闭混淆后就好了

排查功能异常步骤：

在 obfuscation-rules.txt 中配置-disable-obfuscation 选项关闭混淆，确认问题是否由混淆引起。

若确认开启混淆后功能出现异常，请先阅读文档，了解模块已配置的混淆规则的能力和需要配置白名单的语法场景，以确保应用功能正常。下文简要介绍默认开启的四项选项功能，详情请参阅对应选项的完整描述。

• -enable-toplevel-obfuscation为顶层作用域名称混淆开关。

• -enable-property-obfuscation为属性混淆开关。配置白名单的主要场景包括网络数据访问、json 字段访问、动态属性访问、调用 so 库接口等。需要使用-keep-property-name来保留指定的属性名称。

• -enable-export-obfuscation为导入/导出名称混淆。一般与-enable-toplevel-obfuscation 和-enable-property-obfuscation 选项配合使用。配置白名单的主要场景为模块对外接口不能混淆。需要使用-keep-global-name来保留指定的导出/导入名称。

• -enable-filename-obfuscation为文件名混淆。配置白名单的主要场景为动态 import 或运行时直接加载的文件路径。需要使用-keep-file-name来保留这些文件路径及名称。

排查需要配置的白名单场景时，推荐使用混淆助手配置保留选项，可以快速识别需要配置的保留选项和白名单字段。也可以参考以下典型报错案例，若遇到相似场景，可参照对应解决方法快速处理。

若以下报错案例中未找到相似场景，建议依据各项配置功能正向定位（若不需要相应功能，可删除对应配置项）。

应用运行时崩溃分析方法：

• 应用运行时异常栈中的行号为编译产物的行号，方法名也可能为混淆后名称；因此排查时建议直接根据异常栈查看编译产物，进而分析哪些名称不能被混淆，然后将其配置到白名单中。

应用在运行时未崩溃但出现功能异常（如白屏）的分析方法：

• 打开应用运行日志：选择 HiLog，检索与功能异常直接相关的日志，定位问题发生的上下文。

• 定位异常代码段：分析日志，找到引发功能异常的代码块。

• 增强日志输出：在疑似异常的功能代码中，增加日志打印以检查数据是否正常。

• 分析并确定关键字段：通过分析新增的日志输出，判断数据异常是否由混淆导致。

• 配置白名单以保护关键字段：将混淆后对应用功能有直接影响的关键字段添加到白名单中。

排查非预期的混淆能力

若出现预期外的混淆效果，检查是否由于依赖的本地模块或三方库开启了某些混淆选项。

假设当前模块未配置-compact，但混淆的中间产物中代码都被压缩成一行，可按照以下步骤排查混淆选项：

1. 查看当前模块的 oh-package.json5 中的 dependencies，此字段记录了当前模块的依赖信息。

2. 在依赖的模块/三方库中的混淆配置文件内检索"-compact"：

在本地依赖的 library 中的 consumer-rules.txt 文件中检索"-compact"。
在工程目录下的 oh_modules 文件夹中，对全部的 obfuscation.txt 文件检索"-compact"。

FAQ 2：上架审核中泄漏问题如何分析？

示例：

问题描述：您的应用运行过程中存在内存泄漏问题，原因：包名_JS_LEAK.。问题现象：应用卡顿甚至发生闪退。

稳定性分析

资源泄漏产生的原因是程序未正确释放已分配的内存资源，导致资源被持续占用无法再利用。故障日志文件名： memleak-js-[process_name]-[pid]-[tid]-[timestamp].rawheap 或者.heapsnapshot，该文件记录了对象堆内存的详细信息。API14 后，通过 DevEco Studio 或浏览器打开展示，将其导入 DevEco Studio 并展示，详情见Snapshot模板基本操作-离线导入内存快照文件。导入后可参照 JS 内存泄漏分析方法分析定位，详情见稳定性分析-资源泄漏类问题分析方法-内存泄漏分析方法-JS泄漏。

分析 snapshot 日志，基于 Retained Size 排序后，发现主要占用为"JSObject"，可使用 LocalHandle 工具分析，可参考ArkTS 内存泄漏定位神器！带你揭秘鸿蒙最新LocalHandle泄漏检测工具。

稳定性优化

内存泄漏优化建议 1：使用定时器组件销毁时一定要调用 clearTimeout 和 clearInterval，否则对象无法析构。详情见资源泄漏类问题优化建议-内存泄漏问题优化建议1。

内存泄漏优化建议 2：异常分支需要关注释放申请的内存，详情见资源泄漏类问题优化建议-内存泄漏问题优化建议2 。

稳定性检测

对于能比较稳定复现，有特定业务场景的泄漏问题，可以使用 IDE 工具对比两次 snapshot 快照的方式来定位问题，通过对比两次快照文件，可以获知新增了哪些虚拟机对象，这时候可以结合业务逻辑分析这些新增对象是否合理来判断是否真的泄漏。使用 Snapshot 检测虚拟机内存泄漏，使用 IDE 工具检测虚拟机内存泄漏的详细步骤，详情见稳定性检测-资源泄漏类问题检测-内存泄漏类问题检测方法-JS内存泄漏问题检测方法。

如果观测到应用进程的 ArkTS 内存持续增长，需要定位 GC 机制无法回收的 ArkTS 内存泄漏对象，可参考使用JsLeakWatcher开发实践。

APMS 运维

APMS 上运维态高效处理 ArkTS 泄漏，支持应用灰度下发，故障预警和 AI 智慧分析，详情见运维态高效处理ArkTS泄漏。

更多示例详见：【上架检测FAQ】内存泄漏-华为开发者话题|华为开发者联盟

FAQ 3：input 瞬时栈,主线程卡死的崩溃日志如何分析？

【问题场景】：怎么分析，主线程卡死的崩溃日志。

【解决方案】：使用冻屏增强日志定位繁忙类问题

概述

用户在使用应用时，如果出现点击无反应或应用无响应等情况，并且持续时间超过一定限制，就会被定义为应用冻屏（AppFreeze），即应用无响应。系统会检测应用无响应，并生成 AppFreeze 日志，供应用开发者分析。从 API 21 开始，支持获取AppFreeze 的增强日志。该日志通过采集整机及主线程的运行负载，并抓取多份主线程调用栈，帮助开发者知晓函数调用耗时。

日志获取及规格可以参考：AppFreeze（应用冻屏）检测

增强日志具体用法详见：使用冻屏增强日志定位繁忙类问题-华为开发者话题|华为开发者联盟