React-Native-Video 内存泄漏问题分析与解决方案

问题背景

在 React-Native-Video 6.7.0 版本中，iOS 平台（特别是 iOS 18 系统）上存在一个严重的内存泄漏问题。当开发者卸载视频组件时，RCTVideo 的 deinit 方法没有被正确调用，导致内存无法释放。这个问题在真实设备上尤为明显，长时间播放多个视频后会导致设备发热，严重影响应用性能和用户体验。

问题根源分析

经过技术团队深入调查，发现该内存泄漏主要由两个关键因素引起：

1. IMA 广告管理器的闭包强引用：在 RCTIMAAdsManager 初始化时，传递的 pipEnabled 闭包直接捕获了 self 的强引用，而没有使用弱引用。这导致了一个引用循环，使得 RCTVideo 实例无法被释放。

2. ReactNativeVideoManager 的视图注册问题：ReactNativeVideoManager 的共享实例在 registerView 方法中强持有了 RCTVideo 实例，但这些实例实际上并未被使用。这种设计缺陷造成了不必要的内存保留。

技术解决方案

解决方案一：修复 IMA 广告管理器的闭包引用

原始代码存在强引用问题：

_imaAdsManager = RCTIMAAdsManager(video: self, pipEnabled: isPipEnabled)

修正后的代码应该使用弱引用：

_imaAdsManager = RCTIMAAdsManager(video: self, pipEnabled: { [weak self] in
    return self?.isPipEnabled() ?? false
})

这种修改确保了当 RCTVideo 实例需要被释放时，不会因为闭包的强引用而被保留。

解决方案二：优化 ReactNativeVideoManager 的视图管理

需要清理 ReactNativeVideoManager 中未使用的视图注册功能。具体措施包括：

1. 审查 registerView 方法的实现逻辑
2. 移除不必要的强引用
3. 确保视图卸载时能够正确释放相关资源

问题影响与验证

该内存泄漏问题会导致以下不良影响：

1. 内存占用持续增长，特别是在频繁加载/卸载视频组件的场景下
2. 设备发热问题，影响用户体验
3. 应用性能下降，可能导致卡顿或崩溃

验证问题是否修复的方法：

1. 在视频组件卸载后，检查 deinit 方法是否被调用
2. 使用 Xcode 的内存调试工具观察内存变化
3. 长时间运行视频播放测试，监控内存增长情况

最佳实践建议

为了避免类似的内存问题，建议开发者在 React-Native 开发中遵循以下原则：

1. 对于闭包中的 self 引用，总是优先考虑使用弱引用
2. 定期使用 Instruments 工具检查内存泄漏
3. 对于共享实例持有的对象，要特别小心引用关系
4. 在组件卸载时，确保所有资源都被正确释放
5. 对于视频等资源密集型组件，实现完善的生命周期管理

总结

React-Native-Video 的内存泄漏问题通过修复引用循环和优化资源管理得到了有效解决。开发者应及时更新到包含这些修复的版本，并在自己的项目中注意类似的内存管理问题。良好的内存管理习惯对于构建高性能的 React-Native 应用至关重要。