Firebase iOS SDK 中 FPRNetworkTrace 崩溃问题分析与解决方案

问题背景

在 Firebase iOS SDK 11.6.0 版本中，开发者报告了一个与性能监控相关的崩溃问题。该崩溃发生在 FPRNetworkTrace.m 文件中，主要涉及网络请求跟踪功能与 Alamofire 网络库的交互过程中。

崩溃现象分析

崩溃堆栈显示问题发生在 libobjc.A.dylib 的 objc_moveWeak 方法中，调用链如下：

1. 从 Alamofire 的 Session 队列开始
2. 经过 FirebasePerformance 的 FPRNetworkTrace 启动过程
3. 最终在 CoreFoundation 的通知注册环节崩溃

关键崩溃点位于 FPRNetworkTrace.m 文件的第 207 行，即 -[FPRNetworkTrace start] 方法中。从技术角度看，这很可能是一个对象生命周期管理问题，涉及到弱引用在通知注册过程中的处理。

问题根源探究

深入分析后，我们发现几个关键点：

1. 默认网络追踪冲突：Firebase Performance 默认会自动追踪 URLSession 请求，而 Alamofire 正是基于 URLSession 构建的。这种自动追踪机制在某些情况下会导致资源竞争或对象生命周期问题。

2. 名称转换问题：有开发者报告在将网络请求名称转换为 FPRReservableName 类型时，即使原始名称非空，转换结果却变成了 nil，这可能是崩溃的诱因之一。

3. 线程安全问题：崩溃发生在 Alamofire 的根队列中，暗示可能存在跨线程访问或线程安全问题。

解决方案

基于问题分析，我们推荐以下解决方案：

1. 禁用默认网络追踪

对于使用 Alamofire 或其他高级网络库的项目，可以禁用 Firebase Performance 的默认网络追踪功能：

let config = Performance.sharedInstance()
config.isInstrumentationEnabled = false

这能有效避免 SDK 与第三方网络库的潜在冲突。

2. 手动添加关键性能追踪

禁用自动追踪后，可以对关键网络请求添加手动性能追踪：

let trace = Performance.startTrace(name: "network_request")
// 执行网络请求
// 请求完成后
trace.stop()

3. 升级依赖版本

确保使用最新版本的 Firebase SDK 和相关依赖库，因为后续版本可能已经修复了类似问题。

最佳实践建议

1. 评估追踪需求：不是所有网络请求都需要性能追踪，只追踪关键业务请求可以减少潜在问题。

2. 测试环境验证：在测试环境中充分验证性能追踪功能，特别是与第三方网络库的兼容性。

3. 监控崩溃率：即使禁用了自动追踪，仍需关注性能追踪功能本身的稳定性。

总结

Firebase Performance 的网络追踪功能虽然强大，但在与某些第三方网络库（如 Alamofire）配合使用时可能出现稳定性问题。通过禁用自动追踪、选择性添加手动追踪以及保持SDK更新，可以构建更稳定的性能追踪体系。开发者应根据项目实际需求，权衡追踪的全面性与系统稳定性。