React Native Video 在 Android 构建后无法播放视频的问题分析

问题现象

在使用 React Native Video 6.6.2 版本时，开发者在 Android 平台上遇到了一个典型问题：在开发环境下视频播放正常，但在构建发布版本后视频无法播放，控制台报错显示"Playback error"和"ExoPlaybackException: Source error"。

错误分析

从错误堆栈中可以清晰地看到，核心问题是"Malformed URL"，这表明视频源路径处理存在问题。特别值得注意的是，当开发者尝试使用本地资源文件时（通过require引入），系统错误地将本地文件路径当作网络URL处理，导致了URL格式异常。

根本原因

深入分析后，发现问题的根源在于缓存配置与本地资源加载的冲突。当开发者设置了bufferConfig属性（特别是cacheSizeMB）时，React Native Video内部会尝试将视频源视为网络资源进行缓存处理。然而对于本地资源文件，这种缓存机制是不必要且会导致错误的。

解决方案

针对这一问题，开发者可以采用以下几种解决方案：

1. 移除bufferConfig配置：这是最简单的解决方案。由于默认的cacheSize为0，移除bufferConfig可以避免缓存机制对本地资源的错误处理。

2. 正确使用source属性：对于本地资源，推荐直接使用source={require('path/to/video')}的方式，而不是source={{uri: require('path/to/video')}}。前者是React Native处理本地资源的规范方式。

3. 路径规范化：避免在路径中使用特殊符号如"~"，改为使用相对路径或绝对路径，这可以避免潜在的路径解析问题。

技术建议

对于需要在Android平台上使用React Native Video播放本地视频的开发者，建议遵循以下最佳实践：

• 优先使用require直接引入资源文件
• 仅在需要缓存网络视频时才配置bufferConfig
• 保持路径简洁规范，避免特殊符号
• 在开发环境和生产环境都进行充分测试

这个问题反映了React Native生态中一个常见的陷阱：开发环境与生产环境的差异。开发者在处理媒体资源时，应当特别注意这种差异，确保功能在两种环境下都能正常工作。