React Native Video组件Android平台请求头丢失问题分析与解决方案

问题背景

在React Native Video组件6.0.0版本的Android平台上，开发者发现当视频源为MP4格式时，自定义的HTTP请求头（如Referer）会出现丢失现象。这个问题在beta 5版本中表现正常，但在正式版中却出现了异常行为。

问题现象

经过详细测试和Charles代理抓包分析，发现以下具体现象：

1. 播放器启动时会发起两次请求：

   • 第一次是HEAD请求（用于探测文件类型）
   • 第二次是GET请求（实际获取视频内容）

2. 请求头表现差异：

   • HEAD请求中所有自定义请求头都能正常传递
   • GET请求中自定义请求头全部丢失
   • 在beta 5版本中，GET请求能正确携带所有请求头

根本原因

深入分析后发现，这个问题与缓存机制密切相关：

1. 当设置cacheSizeMB为0（禁用缓存）时，请求头能正常发送
2. 问题首次出现在PR #3739合并之后
3. DataSourceUtil类中的静态变量defaultHttpDataSourceFactory和defaultDataSourceFactory只会初始化一次
4. 缓存分配是通过RNVSimpleCache.INSTANCE.setSimpleCache()调用完成的

技术细节

核心问题出在DataSourceUtil类的实现上：

// 原问题代码
public static DataSource.Factory getDefaultDataSourceFactory(...) {
    if (defaultDataSourceFactory == null || (requestHeaders != null && !requestHeaders.isEmpty())) {
        defaultDataSourceFactory = buildDataSourceFactory(...);
    }
    return defaultDataSourceFactory;
}

这段代码存在两个关键缺陷：

1. 静态变量只会在首次初始化或请求头非空时更新
2. 一旦初始化后，后续请求头变更不会触发重新构建DataSourceFactory

解决方案

社区贡献者提出了有效的修复方案：

// 修复后的代码
public static DataSource.Factory getDefaultDataSourceFactory(...) {
    defaultDataSourceFactory = buildDataSourceFactory(...);
    return defaultDataSourceFactory;
}

这个修改确保：

1. 每次调用都会重新构建DataSourceFactory
2. 请求头变更能及时生效
3. 解决了并行播放多个DRM流时的潜在问题

影响范围

该问题主要影响：

1. Android平台
2. 旧架构（Old architecture）
3. MP4格式视频流（m3u8不受影响）
4. 需要使用自定义请求头的场景

最佳实践建议

对于开发者而言，建议：

1. 及时更新到包含修复的版本
2. 如需自定义请求头，确保测试GET请求的实际效果
3. 对于敏感请求头（如Referer），考虑禁用缓存作为临时解决方案
4. 并行播放多个需要不同请求头的视频时，注意测试兼容性

总结

这个问题展示了底层网络组件实现细节对上层功能的影响。通过社区协作和详细的问题分析，最终找到了既保持性能又确保功能完整性的解决方案。这也提醒开发者在实现缓存机制时需要特别注意请求处理的完整性。