本原创文章帖发布在华为开发者联盟社区，欢迎开发者前往访问评论交流，更多与该内容相关讨论，请点击原帖查看：应用冻屏检测与主线程超时检测差异-华为开发者话题 | 华为开发者联盟
简介
应用冻屏检测与主线程超时检测是两种不同层面的性能问题检测机制。本文档对比两者的核心差异，帮助开发者理解何时关注应用冻屏检测，何时关注主线程超时检测。
说明：本文仅适用于 Stage 模型下的应用。在根据本文分析日志前，开发者需要具备 JS 在系统中运行情况、C++程序堆栈信息的相关基础知识。
核心差异对比
检测机制对比
检测类型对比
应用冻屏检测类型
应用冻屏检测是系统级检测机制，检测主线程长时间阻塞、输入响应超时、生命周期切换超时等问题。
主线程超时检测类型
主线程超时检测是性能监控机制，检测主线程单次事件处理耗时，帮助开发者发现性能瓶颈。
重要说明：
主线程超时检测与应用冻屏检测的 THREAD_BLOCK_3S/6S 是两种独立的检测机制：
• 主线程超时检测关注的是单次事件处理耗时（毫秒级），用于性能优化和流畅度分析。
• THREAD_BLOCK_3S/6S 关注的是主线程长时间阻塞（秒级），是系统保护机制，用于检测应用无响应问题。
• 主线程超时检测不会触发应用冻屏事件，两者互不影响。
日志获取方式对比
日志存储位置对比
何时关注应用冻屏检测
适用场景
开发者在以下场景应重点关注应用冻屏检测：
1. 用户投诉应用无响应：用户反馈应用点击无反应、界面卡死等问题时，应优先排查应用冻屏日志。
2. 应用被系统强制终止：应用在运行过程中被系统杀死，且没有明确的崩溃日志时，应排查应用冻屏日志。
3. 生命周期切换异常：应用在启动、切前台、切后台等生命周期切换过程中出现异常，应关注 LIFECYCLE_TIMEOUT 事件。
4. 输入响应延迟：用户点击或触摸操作无响应，应关注 APP_INPUT_BLOCK 事件。
问题定位思路
关键日志字段
应用冻屏日志中重点关注以下字段：
何时关注主线程超时检测
适用场景
开发者在以下场景应重点关注主线程超时检测：
1. 应用流畅度优化：在优化应用流畅度时，主线程超时检测可以帮助发现影响帧率的性能瓶颈。
2. 性能压测分析：在性能测试过程中，需要分析主线程的任务执行情况，找出耗时操作。
3. 帧率问题定位：应用出现掉帧、卡顿等流畅度问题时，应关注主线程超时日志。
4. 开发阶段性能监控：开发阶段可主动接入 HiCollie 检测，监控关键业务逻辑执行时长。
问题定位思路
关键日志字段
主线程超时日志中重点关注以下字段：
两者关系说明
演进关系
主线程超时检测与应用冻屏检测存在演进关系：
1. 主线程超时检测是应用冻屏检测的前置告警机制。当主线程处理时长超过 150ms 时，会触发主线程超时检测的堆栈采集；当超过 450ms 时，会触发 trace 采集。
2. 应用冻屏检测是主线程长时间阻塞的严重后果。当主线程阻塞超过 3s 时会触发告警，超过 6s 时会生成应用冻屏事件并杀死应用进程。
互补关系
两者互为补充，形成完整的性能监控体系：
AppFreeze 增强日志（采样栈）与主线程超时检测堆栈采集对比
AppFreeze 增强日志（采样栈）
从 API version 21 开始，支持获取 AppFreeze 的增强日志。该日志通过采集整机及主线程的运行负载，并抓取多份主线程调用栈，帮助开发者分析问题根源。
实现原理：
1. 应用进程在运行时发生 THREAD_BLOCK_3S 或 LIFECYCLE_HALF_TIMEOUT 时，会开启采集主线程调用栈流程。
2. 应用进程在运行时发生 THREAD_BLOCK_6S、LIFECYCLE_TIMEOUT 或 APP_INPUT_BLOCK 时，会停止采集流程，并计算周期内的 CPU 信息。一般情况下，会抓取 1~10 次堆栈日志。
日志内容：
对比分析
AppFreeze 增强日志（采样栈）与主线程超时检测的堆栈采集均通过采样方式获取主线程调用栈，但存在以下差异：
互斥关系说明
注意：
AppFreeze 增强日志的采样栈会与 MAIN_THREAD_JANK 冲突：
• 如果应用接入 MAIN_THREAD_JANK 的 setEventConfig 接口自定义配置采集堆栈的个数，AppFreeze 增强日志的采集堆栈个数会与应用当前配置一致。
• 开发者在分析应用冻屏问题时，如需详细的堆栈信息，可同时参考 AppFreeze 增强日志（采样栈）和主线程超时检测的堆栈文件。
选择建议
最佳实践建议
开发阶段
1. 主动接入主线程超时检测，监控关键业务逻辑执行时长。
2. 使用 HiCollie 设置自定义超时阈值，提前发现性能问题。
3. 定期分析主线程超时日志，优化热点代码。
测试阶段
1. 在性能测试中关注主线程超时日志，分析帧率和流畅度问题。
2. 在稳定性测试中关注应用冻屏日志，排查严重阻塞问题。
发布阶段
1. 应用冻屏检测作为系统级保护机制，无需额外适配。
2. 主线程超时检测日志可帮助分析用户反馈的卡顿问题。
🔗 官网开发者学堂视频：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 技术交流群】
