3. ANR日志采集方法

当导航组件因栈溢出导致ANR时，第一反应不是猜测原因，而是快速、完整地采集现场日志。本章按照“现象识别 → 数据采集 → 原因定位 → 修复动作 → 复测 → 预防”的闭环，聚焦数据采集环节，介绍 adb bugreport、logcat 过滤、dumpsys activity 三种核心方法，并给出直击导航栈溢出的采集准则与排查表格。

3.1 现象识别：导航栈溢出的典型表现

在正式采集日志前，先确认是否属于导航栈溢出型ANR。常见现象包括：

• 应用无响应：用户点击返回键或导航图标后，界面卡死超过5秒。
• 重复导航操作：用户频繁进入/退出深层子页面（超过30层），突然触发ANR。
• 日志关键词：ANR message 中包含 “NavigationStack overflow” 或 “FragmentManager stack depth exceeded”。

3.2 数据采集：三大工具及操作要点

采集现场数据必须快、全、准。以下三种方法按优先级排列，建议同时执行。

工具	用途	关键产出	采集时机
adb bugreport	系统级快照	trace.txt、dumpstate.txt	ANR发生后尽快执行
logcat + 过滤	实时导航日志	过滤器提取导航组件栈变化	复现ANR时持续抓取
dumpsys activity	Activity栈快照	当前栈深度、fragment回退栈列表	ANR发生时或刚恢复后

3.2.1 adb bugreport 获取完整trace

此命令生成系统诊断ZIP包，内含所有进程的native/Java栈、CPU/内存快照。对导航栈溢出最有用的是 traces.txt（ANR发生时刻主线程的栈信息）。

# 在ANR弹出后立即执行（确保未重启应用）
adb bugreport bugreport_$(date +%Y%m%d_%H%M%S).zip

• 重点分析：解压后找到 traces.txt，搜索应用包名下的线程 “main”。栈顶若出现 androidx.navigation.NavController.navigate→FragmentManagerImpl.moveToState 反复数百层，则确认栈溢出。
• 避坑：优先抓取原始bugreport，不要用 adb bugreport brief 等精简版，否则可能缺失ANR主线程栈。

3.2.2 logcat 过滤导航组件日志

导航组件使用 NavController 内部日志标签，默认level为DEBUG。采集命令：

# 同时保留ANR发生后日志缓冲区
adb logcat -v threadtime -b main -b system | grep -E "(NavController|FragmentManager|NavigationStack)" > nav_anr.log

通过过滤可观察到：

• NavigationStack depth=XX —— 记录每次push/pop后的栈深度。
• FragmentManager: performPendingTransactions —— 堆栈频繁提交导致死循环。
• BackStackEntry count=XX —— 回退栈条目数异常增长。

3.2.3 dumpsys activity 输出Activity栈和Fragment栈

此命令提供当前运行中的Activity以及Fragment回退栈列表，直接观察栈深度。

adb shell dumpsys activity activities | grep -E "(Stack #|fragment|NavHost)"

• 输出片段示例：

  Stack #1:
    Task id #183
      * TaskRecord{d46cd5f #183 A=com.example.nav U=0 Stack=1}
        Activities: 1
          * ActivityRecord{... com.example.nav/.MainActivity}
            Fragments: 1
              FragmentManager{... in NavHostFragment}
                mBackStackNesting=42   // 正常值≤10
                mBackStackIndex=42

当 mBackStackIndex 远大于预期（如42），且应用尚未ANR但操作卡顿，说明导航栈已经严重膨胀，即将溢出。

3.3 排查表：三方法整合判断

采集方法	关键指标	正常值	溢出异常值
bugreport traces.txt	主线程调用栈深度	＜100帧	＞500帧且连续重复navigate/moveToState
logcat NavController	栈深度计数器	≤10	≥30且持续增长
dumpsys activity	mBackStackNesting	≤10	≥30

3.4 故障树：导航栈溢出数据采集决策

以下故障树帮助你在现场快速定位采集方向：

• 根节点：ANR发生
  • 是否立即抓取bugreport？
    • 是 → 获取traces.txt → 分析主线程栈
    • 否 → 是否已重启应用？
      • 是 → 只能依靠logcat回放（需提前开启持久日志）
      • 否 → 立即执行bugreport + dumpsys activity
  • 是否在logcat中看到 NavigationStack depth 字眼？
    • 是 → 记录深度峰值，判断是否超过30
    • 否 → 需加强过滤词包含 BackStackEntry、fragment

3.5 数据采集流程总图

3.6 采集复盘检查清单

完成日志采集后，对照以下清单确认数据完整性：

• □ bugreport ZIP已保存到本地，内包含 traces.txt 且文件大小 > 100KB
• □ logcat过滤日志 nav_anr.log 中包含ANR发生前后各2秒的记录
• □ dumpsys activity 输出中明确显示了 mBackStackNesting 值
• □ 三个工具的时间戳可以对齐（检查 threadtime 与bugreport时间戳）