React Native Video 组件在 iOS 15 上的卸载后继续播放问题解析

问题现象

在 React Native Video 组件（特别是 v5.2.1 和 v6.0.0-beta.5 版本）的使用过程中，开发者发现了一个特定于 iOS 15 系统的异常行为：当视频组件被卸载（unmounted）后，视频仍然会继续播放。这个问题在 iOS 17 及更高版本上不会出现，但在 iOS 15 系统上表现明显。

问题本质

这个问题的核心在于 iOS 15 系统上视频播放器的资源释放机制存在缺陷。当 React Native 组件被卸载时，底层原生代码没有正确释放播放器实例，导致播放器继续运行。这属于典型的内存管理和生命周期控制问题。

技术分析

从代码层面来看，问题出在 RCTVideo.swift 文件中。当组件被销毁时，虽然执行了移除播放器图层和清空观察者的操作，但没有显式地将播放器实例置为 nil。在 iOS 15 上，这种不完整的清理会导致播放器继续运行。

解决方案

临时解决方案

开发者可以采用以下临时解决方案：

1. 手动暂停法：在组件卸载前手动调用 pause() 方法

useLayoutEffect(() => {
  return () => {
    player.pause();
  };
}, []);

2. 生命周期钩子法：在组件的卸载阶段显式暂停播放器

根本解决方案

仓库协作者提出了一个代码补丁方案，需要在 RCTVideo.swift 文件中显式地将 _player 置为 nil：

deinit {
    self.removePlayerLayer()
    _pip = nil
    _playerObserver.clearPlayer()
    _player = nil  // 新增这行代码
}

版本兼容性说明

这个问题主要影响以下环境组合：

• React Native Video v5.2.1 和 v6.0.0-beta.5
• iOS 15.x 操作系统
• 新旧架构都可能出现此问题

值得注意的是，在 iOS 16.x 及更高版本上，系统自身的资源管理机制已经修复了这个问题，因此不会出现类似现象。

最佳实践建议

1. 对于必须支持 iOS 15 的应用，建议采用手动暂停的临时解决方案
2. 长期来看，应该等待官方合并修复补丁或升级到已修复的版本
3. 在视频组件开发中，始终要注意添加卸载时的清理逻辑
4. 针对不同 iOS 版本进行充分测试，特别是生命周期相关的功能

问题延伸思考

这个问题反映了跨平台开发中一个常见挑战：不同系统版本对资源管理的实现差异。作为开发者，我们需要：

1. 充分了解各平台版本的特性和限制
2. 在组件设计中考虑完善的资源清理机制
3. 建立针对不同系统版本的测试矩阵
4. 对于媒体播放等系统资源密集型功能，要特别注意生命周期管理

通过这个案例，我们可以更好地理解 React Native 桥接层的工作原理，以及在处理原生组件时需要注意的关键点。