Sentry React Native 项目中的启动崩溃问题分析与解决方案

问题背景

在React Native应用开发中，集成Sentry进行错误监控是一个常见需求。然而，近期有开发者在使用Sentry React Native SDK时遇到了应用启动即崩溃的问题，错误信息显示"Super expression must either be null or a function"。这个问题特别出现在使用Expo框架和Sentry React Native SDK 6.x版本的环境中。

错误现象

开发者报告的主要症状包括：

1. 应用启动时立即崩溃
2. 控制台显示TypeError错误，提示"Super expression must either be null or a function"
3. 错误堆栈指向ExpoRoot组件而非直接指向Sentry
4. 即使仅初始化Sentry而不使用其包装功能，问题依然存在

根本原因分析

经过深入排查，发现问题的核心在于依赖版本冲突。具体表现为：

1. 版本不兼容：项目中同时使用了Sentry React Native SDK 6.10.0和Sentry Node/Next.js SDK 9.13.0
2. 依赖混用：Sentry React Native 6.x系列设计上依赖Sentry JavaScript SDK 8.54.0版本，而项目中其他包使用了9.x版本
3. 打包问题：在monorepo环境下，Yarn等包管理器可能会将不同版本的Sentry核心库混合打包，导致运行时类型检查失败

解决方案

临时解决方案

最直接的解决方法是统一Sentry相关依赖的版本：

1. 将所有@sentry/*包降级到8.54.0版本
2. 确保package.json中所有Sentry相关依赖版本一致
3. 清理node_modules并重新安装依赖

长期解决方案

对于需要同时使用新旧版本Sentry SDK的项目，可以考虑：

1. 使用Yarn的nmHoistingLimits配置：通过设置workspaces级别的依赖隔离，防止版本冲突
2. 等待Sentry React Native V7发布：新版本将全面兼容Sentry JavaScript SDK 9.x系列
3. 优化monorepo配置：明确指定各子项目的依赖版本，避免自动提升

最佳实践建议

1. 版本一致性：在monorepo中，尽可能保持所有Sentry相关包的版本一致
2. 依赖隔离：对于必须使用不同版本的情况，配置包管理器进行依赖隔离
3. 逐步升级：当Sentry React Native V7发布后，有计划地整体升级所有相关依赖
4. 测试验证：在集成Sentry后，进行全面的启动测试和功能验证

技术深度解析

这个问题的本质是JavaScript的类继承机制在打包过程中被破坏。当不同版本的Sentry核心库被混合使用时：

1. 父类定义可能来自一个版本
2. 子类定义可能来自另一个版本
3. 由于版本差异，继承链断裂，导致"Super expression must either be null or a function"错误

这种问题在monorepo中尤为常见，因为多个子项目可能依赖同一个库的不同版本，而包管理器的依赖解析策略可能导致意外的版本组合。

结论

Sentry React Native集成问题虽然棘手，但通过理解其背后的依赖关系和版本兼容性要求，开发者可以有效地解决这类启动崩溃问题。随着Sentry生态的持续发展，未来版本将提供更好的兼容性和更简单的集成体验。在现阶段，保持依赖版本一致性和合理配置monorepo环境是关键所在。