第1章 崩溃可见性建设：统一上报、去重、聚合与优先级标记

1.1 现象识别：崩溃可见性的盲区

在缺乏统一崩溃采集体系的项目中，常见的现象是：

• 重复崩溃淹没真正问题——同一崩溃每天上报数万次，单点故障被淹没在噪声中。
• iOS 与 Android 上报格式割裂——分析人员需手动合并两份不同的 JSON、堆栈格式，定位耗时翻倍。
• 无聚合规则——仅因线程名不同，同一条代码路径的崩溃被拆成几十条“独立”记录，治理优先级失效。

可见性建设的核心目标：每一个线上崩溃都能被自动采集、去重、聚合，并按严重度赋予可执行的优先级标签。

1.2 数据采集：统一上报协议

建立跨端统一的上报格式，至少包含以下字段：

客户端 SDK 核心上报逻辑示例（伪代码）：

void reportCrash(CrashInfo crash) {
    crash.uuid = generateUUID();
    JSONObject payload;
    payload.put("app_version", crash.appVersion);
    payload.put("os_platform", crash.platform);
    payload.put("crash_type", crash.type);
    payload.put("thread_name", crash.threadName);
    payload.put("stack_frames", crash.frames);
    payload.put("device_model", crash.deviceModel);
    payload.put("timestamp", (int64_t)time(NULL));
    httpPost(CRASH_ENDPOINT, payload.toJson());
}

1.3 去重机制：指纹算法

服务端接收到上报后，需生成崩溃指纹 (crash fingerprint) 用于去重。推荐采用堆栈首帧 + 异常码 + 模块名三级降级策略：

1. 完整堆栈哈希：取前 8 帧的偏移地址（符号化后偏移）拼接后计算 SHA-1。匹配度最高，但受 ASLR 影响需先符号化。
2. 函数名哈希：若符号化失败，取堆栈对应的函数名列表拼接。解决 ASLR 带来的偏移变化。
3. 异常码 + 线程名哈希：备用兜底，防止 NULL 堆栈或空帧。

去重服务伪代码：

string computeFingerprint(CrashReport r) {
    if (!r.symbolicated) { return fallbackHash(r); }
    std::vector<string> topFrames;
    int count = min(8, (int)r.frames.size());
    for (int i = 0; i < count; i++) {
        topFrames.push_back(r.frames[i].funcName);
    }
    return sha1(join(topFrames, "|") + "|" + r.crashType);
}

bool isDuplicate(CrashReport r) {
    string fp = computeFingerprint(r);
    return (fingerprintStore.count(fp) > 0);
}

1.4 聚合规则：分组与归并

去重后的唯一崩溃进入聚合引擎。聚合过程分两阶段：

聚合后生成 Issue 属性：

• crash_count – 总发生次数
• user_impact – 影响的独立用户数
• first_seen / last_seen – 首次/末次时间戳
• top_device – 占比最高的设备型号

1.5 优先级标记：P0 – P3 分级规则

根据影响范围和频率，每个 Issue 自动获得优先级：

1.6 崩溃可见性建设整体流程

下图展示了从客户端采集到服务端聚合、优先级输出及持续反馈的闭环：

1.7 预防与收敛检查清单

• 上报成功率监控：设置端到端成功率 ≥99.5% 的告警阈值。
• 指纹误合并告警：每周抽样 100 条 Issue，人工核对是否出现“不同崩溃被合并”或“同一崩溃被拆分”。
• 优先级降级审核：P0→P1 的自动降级需人工确认，防止遗漏紧急崩溃。
• 聚合超时处理：聚合桶中超过 7 天未复现的低活跃 Issue，自动进入“静默”状态，不被告警覆盖。