React Native Video组件在Android Release版本中无法加载本地视频资源的解决方案

问题背景

在使用React Native Video组件时，开发者可能会遇到一个特殊问题：在Android平台的Release版本中，通过require或import方式引用的本地视频资源无法正常播放，而在Debug版本和iOS平台上则表现正常。这个问题通常表现为视频无法显示，并在Android Studio日志中看到"Malformed URL"或"Source error"等错误信息。

问题现象

当开发者尝试以下方式加载视频资源时会出现问题：

import VideoAsset from './asset.mp4';
// 或
const VideoAsset = require('./asset.mp4');

然后在Video组件中使用：

<Video source={VideoAsset} />

在Debug模式下一切正常，但在Release版本中视频无法播放，控制台会显示类似如下的错误：

Playback error
    androidx.media3.exoplayer.ExoPlaybackException: Source error
    Caused by: androidx.media3.datasource.HttpDataSource$HttpDataSourceException: Malformed URL

问题根源

经过分析，这个问题主要源于React Native Video组件在Android平台上的实现机制：

1. 在Release版本中，React Native会将资源文件打包到APK中，并分配一个资源ID
2. Video组件内部使用ExoPlayer作为播放器引擎
3. 当启用缓存功能时，ExoPlayer会尝试将资源视为网络资源进行处理
4. 由于资源URI格式不正确（如"android.resource:/2131820554"），导致ExoPlayer无法正确识别本地资源

解决方案

目前有两种可行的解决方案：

方案一：禁用缓存功能（推荐）

对于本地资源，可以明确禁用缓存功能，强制ExoPlayer直接读取本地文件：

<Video 
  source={VideoAsset}
  cache={false}  // 关键设置
/>

方案二：修改URI生成逻辑（需要原生代码修改）

对于有原生开发经验的开发者，可以修改Video组件的原生代码，确保生成的资源URI符合Android规范。在Source.kt文件中，修改getUriFromAssetId方法的实现：

return Uri.Builder()
    .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
    .authority(packageName)
    .path(identifier.toString())
    .build()

这将生成格式为"android.resource://com.myapp.android/2131820552"的URI，更符合Android资源URI规范。

验证方法

开发者可以通过以下方式验证问题是否解决：

1. 在Android Studio中查看日志，确认没有"Malformed URL"错误
2. 检查视频是否正常播放
3. 对于方案二，可以添加日志输出验证生成的URI格式是否正确

最佳实践建议

1. 对于本地视频资源，建议始终禁用缓存功能
2. 如果应用同时使用网络视频和本地视频，可以根据资源类型动态设置cache属性
3. 在开发过程中，同时测试Debug和Release版本，尽早发现问题
4. 保持React Native Video组件版本更新，关注官方修复情况

总结

React Native Video组件在Android Release版本中无法播放本地视频资源的问题，主要源于资源URI生成和缓存处理的机制差异。通过禁用缓存或修改URI生成逻辑，可以有效解决这个问题。开发者应根据自身项目需求选择合适的解决方案，确保视频功能在所有平台上都能正常工作。