React Native Video 项目中 Android 平台重复类定义问题的分析与解决

问题背景

在 React Native Video 6.4.4 版本中，Android 平台构建时出现了一个关键错误：Type androidx.media3.exoplayer.dash.DefaultDashChunkSource$Factory is defined multiple times。这个错误导致开发者无法成功生成签名包，影响了应用的发布流程。

错误现象

当开发者尝试构建 Android 签名包时，构建系统报告 DefaultDashChunkSource$Factory 类被重复定义。具体表现为：

1. 该类同时存在于两个不同的位置：

   • React Native Video 模块的构建输出路径
   • 应用主模块的外部库合并后的 classes.dex 文件

2. 问题仅在生成签名包时出现，开发环境下的模拟器运行不受影响

技术分析

这个问题属于典型的依赖冲突，具体来说是 AndroidX Media3 库中的 ExoPlayer DASH 模块被重复包含。在 Android 构建系统中，当同一个类出现在多个依赖路径时，Gradle 无法确定应该使用哪一个版本，从而导致构建失败。

React Native Video 6.4.4 版本引入的变更可能导致了以下情况：

1. 项目直接或间接依赖了多个不同版本的 AndroidX Media3 库
2. 构建系统在合并依赖时未能正确处理重复的类定义
3. ProGuard/R8 代码优化阶段未能消除重复类

解决方案

临时解决方案

开发者可以采取以下临时措施绕过问题：

1. 在应用的 build.gradle 文件中添加排除规则：

implementation(project(':react-native-video')) {
    exclude group: 'androidx.media3', module: 'media3-exoplayer-dash'
}

2. 降级到 6.4.3 版本，等待官方修复

根本解决方案

React Native Video 团队在后续版本中修复了这个问题：

1. 官方在 6.4.5 版本中集成了修复方案
2. 修复方案调整了依赖声明方式，避免了重复包含问题

构建环境清理

无论采用哪种解决方案，都建议执行以下构建环境清理步骤：

1. 执行 Gradle 清理命令：

./gradlew clean

2. 在 Android Studio 中：

   • 执行 Build > Clean Project
   • 执行 Build > Rebuild Project
   • 使用 File > Invalidate Caches / Restart 清除 IDE 缓存

3. 删除 node_modules 并重新安装依赖：

rm -rf node_modules
yarn install

预防措施

为避免类似问题再次发生，开发者可以：

1. 定期检查依赖冲突：

./gradlew :app:dependencies

2. 使用依赖分析工具识别重复依赖

3. 保持 React Native Video 和其他相关库的版本同步更新

总结

Android 平台上的重复类定义问题是 React Native 开发中常见的构建问题之一。React Native Video 6.4.4 版本中的这个问题通过版本更新得到了解决。开发者应养成良好的依赖管理习惯，定期检查项目依赖关系，并在遇到类似构建问题时首先考虑依赖冲突的可能性。

对于使用 Expo 管理的工作流，建议检查是否有多层嵌套的依赖传递导致了冲突，必要时可以通过自定义配置排除特定模块。