4. Logcat 基础：命令详解与缓冲区类型

在 Camera HAL 闪退调试中，logcat 是 Android 平台最核心的日志输出工具。它能够实时捕获来自内核、HAL 层、Framework 以及应用层的日志信息。掌握 logcat 的命令参数、缓冲区类型和日志级别，是定位内存越界、空指针、死锁等闪退问题的第一步。

4.1 logcat 命令详解

logcat 命令的基本语法如下：

adb logcat [选项] [过滤器表达式]

以下表格列出了 Camera HAL 调试中最常用的 logcat 选项：

实战组合命令示例：

# 同时查看 main 和 crash 缓冲区，按线程时间格式输出，过滤 cameraserver 进程
adb logcat -b main -b crash -v threadtime --pid=$(adb shell pidof cameraserver)

# 抓取闪退后的最后 300 行日志并保存到文件
adb logcat -b crash -d -t 300 > crash_last_300.txt

# 实时过滤 CameraHAL 标签的 Error 级别日志
adb logcat -s CameraHAL:E

4.2 缓冲区（Buffer）类型详解

Android 系统将日志划分为多个独立的环形缓冲区。每个缓冲区存储不同类型的日志信息。理解这些缓冲区的用途，是精准提取 Camera HAL 闪退线索的前提。

下表列出了 Android 系统中主要的日志缓冲区类型：

4.3 日志级别（Log Level）

Android 日志系统定义了从低到高 6 个日志级别。在 Camera HAL 调试中，不同级别对应不同的关注度。

过滤器表达式语法：

# 格式：标签:级别
adb logcat -s CameraHAL:E          # 只显示 CameraHAL 标签的 Error 及以上
adb logcat -s camx:W               # 只显示 camx 标签的 Warning 及以上
adb logcat -s *:E                  # 所有标签的 Error 及以上（全局过滤）

# 多标签组合
adb logcat -s CameraHAL:E camx:W mm-camera:I

4.4 缓冲区与日志级别的协同关系（SVG 架构图）

下图展示了 Camera HAL 闪退时，日志从产生到写入不同缓冲区的完整流程，以及日志级别在其中的作用：

4.5 实战：Camera HAL 闪退日志采集流程

以下是一个标准的 Camera HAL 闪退日志采集步骤，结合了缓冲区选择和日志级别过滤：

1. 清空旧日志：adb logcat -b all -c
2. 启动实时监控：

   adb logcat -b main -b system -b crash -v threadtime -s CameraHAL:E camx:W *:F > hal_crash.log &

3. 复现闪退场景：执行 Camera 打开、预览、切换分辨率等操作
4. 停止日志采集：闪退发生后，执行 fg 然后 Ctrl+C
5. 提取关键信息：
   • 从 crash 缓冲区提取 signal 11 (SIGSEGV) 或 signal 6 (SIGABRT) 附近的堆栈
   • 从 system 缓冲区提取 CameraService::connect 或 disconnect 的时间点
   • 从 main 缓冲区提取 HAL 层最后输出的 Error 或 Fatal 级别日志

4.6 常见问题与避坑指南