iOS线上应用在Firebase Crashlytics上报libquic.dylib相关崩溃问题

线上版本应用出现崩溃，崩溃点位为 libquic.dylib qlog_abort_internal + 272

qlog_abort_internal 是QUIC协议实现库的内置致命错误终止函数，出现该崩溃说明libquic运行过程中遇到了不可恢复的逻辑错误，主动触发abort，常见触发场景如下：

• 项目依赖的第三方SDK（含Firebase系列组件、gRPC、Google地图/广告等谷歌系SDK）的内置libquic版本存在已知bug，部分旧版本SDK在弱网、网络切换、断网等场景下会触发日志模块断言失败，主动崩溃
• 手动集成libquic库的场景下，QUIC连接初始化、销毁或数据传输过程中传入了非法参数，触发库内参数校验失败
• 多线程操作QUIC连接上下文时未加锁保护，导致日志模块访问已释放的内存，触发断言逻辑
• 特定iOS小版本（如iOS 15.x早期版本）的系统网络栈与第三方libquic库存在兼容性问题

• 统计Firebase Crashlytics中该崩溃的附带属性，确认崩溃集中出现的iOS系统版本、设备型号、用户网络状态、触发时的用户操作路径，缩小复现范围
• 核对项目中所有依赖的谷歌系SDK版本，查阅对应版本的官方更新日志，确认是否存在已公开的QUIC相关崩溃修复记录
• 测试环境开启libquic详细日志，模拟弱网、网络切换、应用前后台切换等场景复现崩溃，提取崩溃前的日志内容定位具体的断言触发点
• 手动集成libquic的项目可以给qlog_abort_internal函数加符号断点，复现崩溃后通过调用栈确认上层触发逻辑

• 优先将所有依赖libquic的第三方SDK升级到最新稳定版本，90%以上的同类型崩溃都是第三方SDK的已知bug，升级后即可直接修复
• 手动使用libquic的场景，优化QUIC实例的生命周期管理，确保多线程操作加锁，销毁实例后不再调用相关API，同时校验所有传入libquic的参数合法性
• 临时规避方案：如果暂时无法完成SDK升级，可以在相关SDK的配置项中关闭QUIC协议支持，强制使用HTTP/2协议，完全规避libquic的运行逻辑
• 针对仅在特定iOS版本出现的崩溃，可以添加系统版本判断，在对应版本上禁用QUIC协议

内容的提问来源于stack exchange，提问作者Rince Thomas