React Native Video 本地文件播放问题分析与解决方案

问题背景

在 React Native Video 6.3.4 版本中，开发者报告了一个关于本地文件无法播放的问题。这个问题在 iOS 和 Android 平台上都会出现，特别是在 Expo 环境更新后开始显现。当开发者尝试播放示例应用中的前两个本地内容时，播放功能失效。

根本原因分析

经过深入调查，发现问题根源在于项目依赖结构中存在重复的模块加载。具体表现为：

1. @react-native/assets-registry 模块被重复安装
2. 该模块同时存在于两个路径下：
   • 项目根目录的 node_modules 中
   • react-native 子目录的 node_modules 中
3. 系统错误地使用了第二个路径下的模块版本

这种重复安装导致了资源注册和解析的混乱，特别是当 React Native Video 尝试访问本地文件时，系统错误地使用了非预期的模块实例。

临时解决方案

目前可以采取的临时解决方案是：

1. 手动删除重复的模块路径：

   rm -rf node_modules/react-native/node_modules/@react-native/assets-registry
   

2. 确保项目只使用根目录下的模块版本

长期解决方案建议

对于项目维护者和开发者，建议采取以下措施：

1. 依赖清理：使用 npm dedupe 或 yarn dedupe 命令自动优化依赖树
2. 版本升级：考虑升级到最新稳定版(6.4.5)，可能已包含相关修复
3. 依赖锁定：使用 package-lock.json 或 yarn.lock 确保依赖一致性
4. 模块隔离：检查项目配置，确保没有不必要的嵌套 node_modules

开发环境建议

为避免类似问题，建议开发者：

1. 定期清理 node_modules 并重新安装依赖
2. 使用一致的包管理工具(避免混用 npm 和 yarn)
3. 在团队中统一开发环境配置
4. 考虑使用容器化开发环境减少环境差异

总结

React Native 生态系统中模块依赖管理是一个常见痛点，特别是在大型项目或使用多种第三方库时。React Native Video 的这个问题提醒我们，在遇到本地资源访问问题时，不仅要检查权限和路径设置，还需要关注底层依赖结构是否健康。通过良好的依赖管理和环境配置，可以避免大部分类似问题。