跳转到主要内容
Flashduty 将相同原因的错误事件聚合为一个 Issue,减少需要处理的条数。聚合默认开启,无需配置。

聚合规则

新错误事件按以下顺序归入 Issue:
  1. 与已有 Issue 的指纹相同,归入该 Issue。
  2. 指纹不同但错误相似,归入最相似的 Issue。相似度只在同一出错位置的 Issue 之间比较。
  3. 没有相似的 Issue,创建新 Issue。
Android NDK 原生崩溃、iOS 崩溃、Electron 进程终止事件(RenderProcessGone、ChildProcessGone)、Flutter、React Native 应用中的 NDK 崩溃,以及取到了位置的 iOS App Hang、HarmonyOS 冻结 / 卡顿与 Android ANR 只按指纹聚合,不做相似度归并。这类事件的错误消息几乎相同,按相似度归并会把不同位置的崩溃合为一个 Issue。

默认指纹

当错误事件没有携带指纹时,Flashduty 用以下属性计算指纹。Web 应用接入 SDK 的方法见 Web SDK 接入。
计算指纹时,Flashduty 会忽略堆栈帧中的版本号、ID、日期等动态参数。

出错位置

同一句错误消息可能从互不相关的地方抛出。只按消息聚合,应用里每一处 Cannot read properties of undefined (reading 'id') 都会落进同一个 Issue。因此 Flashduty 还把出错位置计入指纹。 位置只保留重新构建后仍然不变的部分:不带行号与列号,不带构建哈希,也不带压缩或混淆后的短名。 没有符号的应用帧按镜像内偏移区分,这个偏移只在单次构建内稳定,因此同一个 iOS 崩溃在每次发版后都可能变成一个新建的 Issue。 iOS 上已处理的错误不取出错位置:这类消息本身通常说明了原因,不取位置才能让已有 Issue 继续接收它们。Android NDK 原生崩溃也不取,它已按堆栈中最顶层的应用原生帧聚合。取不出稳定位置的错误(例如只有混淆帧的 Android 异常)仍只按类型和消息聚合,也只与同样没有出错位置的 Issue 做相似度归并。 Android ANR 的消息固定是 Application Not Responding,HarmonyOS 冻结 / 卡顿的消息也是常量,所以它们只靠出错位置区分:定位到位置的 ANR 与冻结 / 卡顿按位置各成 Issue,不做相似度归并。
出错位置对本次升级之后首次出现的消息生效。升级前已存在的 Web Issue 与 Android 的 Java/Kotlin 异常 Issue 仍按类型和消息接收错误,相似度归并也仍然覆盖它们,因此这些 Issue 保留原有的状态、负责人和处理历史,不会因为位置进入指纹而重新开一个 Issue。iOS 崩溃与 Android ANR 没有这条保留规则:旧的 iOS Issue 只按信号聚合,旧的 Android ANR Issue 只按固定消息聚合,升级后同一信号、同一类 ANR 都会按出错位置分成多个 Issue。

自定义指纹

若默认聚合无法满足需求,您可以通过提供自定义指纹(fingerprint)完全控制错误的聚合行为。
自定义指纹的优先级高于默认指纹。
在手动报告错误时,通过 addError 添加自定义指纹:
  • 自定义 fingerprint 必须为字符串类型
  • 相同服务中具有相同 fingerprint 的错误将被归入同一 Issue
  • 不同服务的错误即使 fingerprint 相同也会被归入不同 Issue
  • 可用 beforeSend 回调过滤无关错误,见下文“第三方脚本错误过滤”

Web 特定注意事项

上传 sourcemap 文件以解码压缩后的堆栈跟踪,确保聚合后的错误堆栈可映射到原始源代码。
SDK 不会自动过滤浏览器扩展或第三方脚本产生的错误。如需排除,请在 beforeSend 中配置:

查看聚合结果

在 Flashduty 平台,导航至「异常追踪」,查看聚合后的 Issue 列表。点击应用卡片上的 Issue 数字,可直达该应用最近 24 小时、状态为「全部」的 Issue 列表,条数与卡片一致。 每个 Issue 包含:

下一步

Issue 状态

了解 Issue 状态流转机制