4、Logcat 缓冲区详解：Main、System、Events、Crash、Security 的区别

说实话，刚接触 Android 开发那会儿，我对着 logcat 的输出也是一脸懵。满屏滚动的日志，根本分不清哪些是系统发的，哪些是我的 App 打的。直到后来我搞清楚了缓冲区的概念——嗯，这玩意儿就像把不同种类的垃圾扔进不同的垃圾桶，分类清晰了，排查问题才能快准狠。

今天我们就来聊聊 Logcat 的五大缓冲区：Main、System、Events、Crash、Security。搞懂它们，你就能像老司机一样，在日志的海洋里精准捞针。

缓冲区是什么？

简单说，缓冲区就是一块内存区域。系统或者 App 输出的日志，会先写到对应的缓冲区里。然后 logcat 命令再从这些缓冲区里把日志读出来展示给你看。

为什么要分缓冲区？

  • 隔离不同来源的日志：App 的日志和系统的日志混在一起，你看着不头疼吗？
  • 按优先级过滤：有些缓冲区只存重要信息，比如 Crash 缓冲区只存崩溃日志。
  • 提高效率：你只关心 App 的 bug，那就只看 Main 缓冲区，不用被系统日志刷屏。

我个人习惯，在调试时至少开两个窗口：一个看 Main，一个看 System。这样 App 的逻辑和系统的反馈能对照着看，问题定位快很多。

五大缓冲区详解

下面这张图，是我自己整理的缓冲区分类逻辑。你看一眼，心里就有谱了。

Logcat 缓冲区分类体系 Logcat 缓冲区 Main App 日志 (Log.v/d/i/w/e) System 系统组件日志 Events 二进制事件日志 Crash 崩溃/异常日志 Security 安全相关日志 每个缓冲区独立存储，互不干扰 使用 -b 参数指定要读取的缓冲区 adb logcat -b main -b system -b crash # 同时读取 Main、System、Crash 三个缓冲区

1. Main 缓冲区

Main 缓冲区存的是啥？ 说白了，就是你 App 里用 Log.v()、Log.d()、Log.i()、Log.w()、Log.e() 打出来的日志。这是开发者最常用的缓冲区。

举个例子：

// 你的 App 代码里这样打日志
Log.d("MainActivity", "onCreate called");
Log.e("MainActivity", "网络请求失败: " + error.getMessage());

这些日志默认都会进到 Main 缓冲区。你用 adb logcat 不加任何参数时，默认读的就是 Main + System 两个缓冲区。

小技巧： 我建议你在调试时只关注 Main 缓冲区，用 adb logcat -b main。这样能过滤掉系统杂音，只看自己 App 的日志。

2. System 缓冲区

System 缓冲区存放的是 系统组件 的日志。比如 ActivityManager、WindowManager、PackageManager 这些系统服务打出来的日志。

为什么要单独分一个 System 缓冲区？

  • 系统日志量很大，如果和 App 日志混在一起，你根本找不到自己的日志。
  • 系统日志通常用于分析系统级问题，比如 ANR、进程被杀、权限拒绝等。

我记得有一次，App 启动特别慢，我查了半天自己的代码，没发现问题。后来看了 System 缓冲区的日志，发现是 PackageManager 在扫描包，耗时很长。嗯，这锅不在我，是系统的问题。

重点： 当你遇到 App 莫名其妙被杀死、或者 ANR 时，一定要看 System 缓冲区。里面会有 ActivityManager: ANR in ... 或者 ActivityManager: Killing ... 这样的关键日志。

3. Events 缓冲区

Events 缓冲区比较特殊。它存的不是普通的文本日志，而是 二进制格式的事件日志。这些日志由 android.util.EventLog 类写入，通常用于记录系统层面的关键事件。

比如：

  • Activity 的启动和停止
  • CPU 频率变化
  • 电池电量变化
  • 系统启动完成

Events 缓冲区的日志不能直接用 logcat 看，需要加上 -b events 参数，并且最好用 logcat -b events -v tag 来格式化输出。

# 查看 Events 缓冲区
adb logcat -b events

# 输出示例（格式化后）
I/am_create_activity( 1234): [0,12345678,com.example.app/.MainActivity,...]
I/am_resume_activity( 1234): [0,12345678,com.example.app/.MainActivity]

说实话，Events 缓冲区平时用得不多。但如果你在做性能分析或者系统级调试，它很有用。比如你想知道某个 Activity 从创建到显示花了多久，Events 里就有精确的时间戳。

注意： Events 缓冲区的日志是二进制的，不要直接用文本编辑器看。用 logcat -b events 命令读取时，系统会自动解析成可读格式。

4. Crash 缓冲区

Crash 缓冲区，顾名思义，存的是 崩溃和异常 相关的日志。包括 Java 崩溃、Native 崩溃、以及 App 的未捕获异常。

这个缓冲区是 Android 7.0 之后才引入的。以前崩溃日志都混在 Main 或者 System 里，找起来很费劲。现在单独分出来，方便多了。

我个人觉得，Crash 缓冲区是排查线上问题的利器。比如你的 App 在用户手机上崩溃了，你可以在 logcat 里只看 Crash 缓冲区：

adb logcat -b crash

输出示例：

--------- beginning of crash
2024-01-15 10:23:45.678 12345-12345/com.example.app E/AndroidRuntime: FATAL EXCEPTION: main
    Process: com.example.app, PID: 12345
    java.lang.NullPointerException: Attempt to invoke virtual method '...' on a null object reference
        at com.example.app.MainActivity.onCreate(MainActivity.java:25)
        ...

我曾经遇到过一个线上 bug，用户反馈 App 闪退，但我自己怎么都复现不了。后来我让用户抓了 logcat，只看 Crash 缓冲区，一下子就定位到了是某个第三方 SDK 在特定机型上触发了空指针。嗯，从那以后，我养成了习惯——每次发布版本前，都会用 logcat -b crash 扫一遍，确保没有隐藏的崩溃。

避坑指南： 我曾经以为 Crash 缓冲区只存 App 的崩溃，后来发现系统服务的崩溃也会写进去。所以如果你看到系统进程的崩溃日志，别慌，先确认是不是你的 App 引起的。

5. Security 缓冲区

Security 缓冲区存的是 安全相关 的日志。比如 SELinux 权限拒绝、设备管理策略变更、密钥库操作等。

这个缓冲区平时用得最少，但一旦涉及权限问题，它就是救命稻草。比如你的 App 在 Android 11 上访问某个文件被拒绝，但你又不知道为什么，这时候看 Security 缓冲区，往往能找到答案。

adb logcat -b security

输出示例：

W/SELinux (  789): avc:  denied  { read } for  pid=12345 comm="com.example.app" name="secret.txt" dev="mmcblk0" ino=12345 scontext=u:r:untrusted_app:s0:c512,c768 tcontext=u:object_r:app_data_file:s0 tclass=file permissive=0

这条日志告诉你：SELinux 拒绝了 App 对 secret.txt 文件的读取操作。原因？权限策略不允许。

小技巧： 如果你的 App 在 Android 高版本上出现奇怪的权限问题，先看 Security 缓冲区。很多时候，不是代码写错了，而是 SELinux 策略或者作用域存储的限制。

如何指定缓冲区？

用 -b 参数，可以指定一个或多个缓冲区。语法很简单：

# 只看 Main 缓冲区
adb logcat -b main

# 同时看 Main 和 System
adb logcat -b main -b system

# 看所有缓冲区（Android 10+ 支持 -b all）
adb logcat -b all

我个人习惯，调试时用 -b main -b system -b crash，三个缓冲区一起看。Main 看 App 逻辑，System 看系统反馈，Crash 看异常。三个对照着，问题基本跑不掉。

缓冲区大小与循环覆盖

每个缓冲区都有大小限制。默认情况下，每个缓冲区是 256KB。当日志写满时，新的日志会覆盖最旧的日志。这就是为什么有时候你发现 logcat 里看不到早期的日志——被冲掉了。

你可以通过 logcat -g 查看当前缓冲区的大小和使用情况：

adb logcat -g

# 输出示例：
main: ring buffer is 256Kb (255Kb consumed), max entry is 5120b, max payload is 4076b
system: ring buffer is 256Kb (128Kb consumed), max entry is 5120b, max payload is 4076b
crash: ring buffer is 256Kb (0Kb consumed), max entry is 5120b, max payload is 4076b
...

如果你觉得 256KB 不够用，可以调整缓冲区大小。不过这个需要 root 权限，或者修改系统属性。一般情况下，256KB 够用了。

注意： 缓冲区是循环覆盖的。如果你在调试一个偶现的 bug，建议尽早抓取 logcat，或者用 logcat -v threadtime 带上时间戳，方便回溯。

总结一下

五大缓冲区，各有各的用途：

缓冲区 存储内容 常用场景
Main App 日志 (Log.v/d/i/w/e) 日常调试、业务逻辑排查
System 系统组件日志 ANR、进程被杀、系统服务问题
Events 二进制事件日志 性能分析、Activity 生命周期追踪
Crash 崩溃/异常日志 Java/Native 崩溃定位
Security 安全相关日志 SELinux 权限、设备管理策略

搞懂了这些缓冲区，你就能像庖丁解牛一样，在 logcat 的海洋里精准找到你需要的信息。下次遇到问题，先问自己一句：这个问题最可能出现在哪个缓冲区？然后直接 -b 参数怼上去，效率翻倍。

好了，这一节就到这里。记住，日志是开发者的眼睛，而缓冲区就是帮你聚焦的那副眼镜。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →