📚 课程目录第2章常见崩溃类型与数据结构

常见崩溃类型与数据结构：Java异常、Native崩溃、ANR、OOM等，字段设计

线上崩溃聚合的第一步是识别崩溃的类型并提取关键字段。不同崩溃类型携带的数据结构差异极大，统一字段设计是聚合与归因的基础。本章首先列举四种核心崩溃类型的技术特征，然后给出适用于灰度验证的统一字段模型。

2.1 四类崩溃的技术特征与原始数据样例

崩溃类型	触发原因	典型平台	原始数据关键段
Java异常	未捕获的Throwable（空指针、数组越界等）	Android（ART/Dalvik）	异常类名、调用栈、线程名、异常消息
Native崩溃	C/C++段错误、SIGSEGV、内存破坏	Android NDK / iOS	信号编号、寄存器状态、内存映射、堆栈指针
ANR	主线程阻塞超过5秒（输入事件/广播/服务）	Android	CPU负载、等待锁、堆栈快照、关键线程trace
OOM	Java堆内存耗尽或物理内存不足	Android / iOS	当前堆大小、最大堆、GC原因、大对象分配

以下为实际线上采集的原始数据片段，用于理解字段提取目标：

// 示例1：Java异常堆栈（Android）
java.lang.NullPointerException: Attempt to invoke virtual method '...' on a null object reference
    at com.example.app.MainActivity.onCreate(MainActivity.java:45)
    at android.app.Activity.performCreate(Activity.java:7891)
    ... 15 more

// 示例2：Native崩溃（信号SIGSEGV）
signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 0x0
r0 0x00000000  r1 0xdeadbeaf  r2 0x...
#00 pc 0x2a34  /system/lib/libc.so (memcpy+12)
#01 pc 0x1e2c  /data/app/.../libnative-lib.so (processData+54)

// 示例3：ANR关键片段（traces.txt）
"main" prio=5 tid=1 Blocked
  at com.example.app.NetworkService.sendRequest(Native)
  - waiting to lock <0x0a1b2c3d> (a java.lang.Object) held by thread "io-thread-3"
  at com.example.app.MainActivity$1.onClick(MainActivity.java:120)
  "Binder:1193_C" prio=5 tid=10 Native
  (no lock info)

// 示例4：OOM日志（Android）
java.lang.OutOfMemoryError: Failed to allocate a 1048576 byte allocation with 65536 free bytes and 63KB until OOM
  at dalvik.system.VMRuntime.newNonMovableArray(Native Method)
  at android.graphics.BitmapFactory.nativeDecodeStream(Native Method)
  Heap: 45MB / 64MB (70% used), largeObj: 12MB

2.2 统一字段模型：跨类型可聚合的数据结构

为了让Java异常、Native崩溃、ANR、OOM能在同一个聚合管道中被比较和归因，必须设计一组“低耦合高内聚”的公共字段，同时保留各类型的专用字段。

字段名	类型	说明	示例
crash_id	string (hash)	由崩溃指纹（堆栈+类型+线程）生成的唯一ID	a1b2c3d4e5
crash_type	enum	JAVA_EXCEPTION / NATIVE_CRASH / ANR / OOM	JAVA_EXCEPTION
timestamp	int64 (ms)	崩溃发生时间（客户端上报时戳）	1716100000123
thread_name	string	崩溃发生时的线程名	main
exception_class	string	Java异常类全名（Native类型为信号名）	java.lang.NullPointerException
exception_message	string	异常消息或信号描述（最长512字节截断）	Attempt to invoke virtual method on null
stack_frames	list<string>	堆栈帧列表（Java行号或Native pc偏移）	[“…”]
app_version	string	客户端版本号（如1.2.3）	1.2.3
os_version	string	操作系统版本（Android 14 / iOS 17）	14
device_model	string	设备型号（如Pixel 8 Pro）	Pixel 8 Pro
native_maps	string (JSON)	Native崩溃时的内存映射摘要（仅NATIVE_CRASH）	{"libc":"0x…","libnative":"0x…"}
anr_cpu_load	float	ANR时的CPU使用率（仅ANR）	0.85
oom_heap_summary	string (JSON)	OOM时的堆大小、最大堆、大对象统计（仅OOM）	{"used":45,"max":64}
build_fingerprint	string	系统构建指纹（用于灰度版本匹配）	google/akita/akita:14/UP1A.231005.007/…

字段设计要点：

crash_id 使用确定性哈希算法（如MurmurHash128）将 crash_type + exception_class + 栈顶6帧 聚合为指纹，确保同一类崩溃具有相同ID（忽略线程名、时间戳等变量）。
stack_frames 存储原始堆栈行，不做符号化；符号化在服务端统一进行，避免客户端膨胀。
专用字段（native_maps、anr_cpu_load、oom_heap_summary）仅当 crash_type 匹配时才会填充，减少传输负担。

2.3 崩溃聚合流程中的字段流转

从客户端采集到最终聚合报告，字段经历“采集 → 清洗 → 提取指纹 → 聚合”四个阶段。下图展示了四类崩溃数据如何统一进入同一个字段模型并生成聚合结果。

2.4 字段提取中的常见错误与规避

常见错误：

堆栈截断不当： 仅存储前10帧可能导致同一崩溃被分为不同聚合桶（关键帧未包含）。建议存储完整堆栈，哈希时取固定深度（如7帧）即可。
混淆Native地址： 直接上传pc地址而不结合so基址，无法在服务端进行符号化。必须上传映射信息（native_maps字段）或至少传递模块名和偏移量。
忽略ANR的锁链信息： ANR聚合通常只关注主线程，但锁竞争信息（等待的锁、持有锁的线程）对归因至关重要，应在stack_frames中保留“waiting to lock”行。
OOM中缺失堆大小： 仅上报“OutOfMemoryError”而无最大堆/已使用堆，无法区分“栈内存不足”与“设备物理内存耗尽”。必须填充oom_heap_summary。

  字段设计检查清单：
  每个崩溃请求至少包含 crash_type、exception_class、stack_frames、app_version、os_version 五个基本字段。
Native崩溃必须额外包含 native_maps（JSON字符串，列出所有加载so的基址和大小）。
ANR必须在 stack_frames 中保留锁信息行，并上传 anr_cpu_load 和 anr_blocked_threads（可选）。
OOM必须包含 oom_heap_summary（usedMB, maxMB）和 oom_alloc_failed_size（尝试分配大小）。
所有字符串字段长度限制：exception_message 512字符，stack_frames 单帧不超过256字符，超出部分截断并附加“… truncated”。