React Native项目构建失败：':app:compileDebugJavaWithJavac'依赖问题求助

问题详情 #

启动React Native Android项目时构建失败，核心错误提示为无法确定':app:compileDebugJavaWithJavac'任务的依赖项，具体错误链：

无法确定null的依赖项。
无法查询此提供者的值，因为它没有可用值。

已尝试操作：清理项目缓存、按文档重装所有开发工具、运行react-native doctor检测环境无异常，但问题仍未解决。

完整错误日志 #

info 正在Android上打开应用...
info JS服务器已在运行。
info 正在启动模拟器...
info 模拟器启动成功。
info 正在安装应用...
Starting a Gradle Daemon, 3 incompatible and 1 stopped Daemons could not be reused, use --status for details
> Task :gradle-plugin:compileKotlin UP-TO-DATE
> Task :gradle-plugin:compileJava NO-SOURCE
> Task :gradle-plugin:pluginDescriptors UP-TO-DATE
> Task :gradle-plugin:processResources UP-TO-DATE
> Task :gradle-plugin:classes UP-TO-DATE
> Task :gradle-plugin:jar UP-TO-DATE
> Task :gradle-plugin:inspectClassesForKotlinIC UP-TO-DATE

> Configure project :app
WARNING:DSL element 'dexOptions'已过时，应移除。
它将在Android Gradle插件8.0版本中被移除。
使用它无任何效果，Android Gradle插件会自动优化dex编译。
5 actionable tasks: 5 up-to-date

info 💡 提示：请运行react-native doctor确保开发环境配置正确，了解更多请访问：https://github.com/react-native-community/cli/blob/main/packages/cli-doctor/README.md#doctor


FAILURE: 构建因异常失败。

* 错误原因：
无法确定任务':app:compileDebugJavaWithJavac'的依赖项。
> 无法确定null的依赖项。
   > 无法查询此提供者的值，因为它没有可用值。

* 建议尝试：
> 使用--stacktrace选项获取堆栈跟踪。
> 使用--info或--debug选项获取更多日志输出。
> 使用--scan选项获取完整分析信息。

* 获取更多帮助：https://help.gradle.org

BUILD FAILED in 55s
info 使用--verbose标志运行CLI获取更多详细信息。

解决方案 #

• 清理Gradle缓存并重启Daemon
  执行以下命令彻底清理Gradle相关缓存：

  cd android && ./gradlew clean
  ./gradlew --stop
  rm -rf ~/.gradle/caches
  cd .. && npx react-native run-android
  

• 移除过时的dexOptions配置
  打开android/app/build.gradle，删除其中的dexOptions块（日志已提示该配置在AGP 8.0+失效）

• 校验Gradle与AGP版本兼容性
  打开android/build.gradle，确保Android Gradle插件（AGP）和Gradle版本匹配：

  • AGP 7.0.x → Gradle 7.0+
  • AGP 7.1.x → Gradle 7.2+
  • AGP 7.2.x → Gradle 7.3+
  • AGP 7.3.x → Gradle 7.4+
  • AGP 8.0.x → Gradle 8.0+

• 检查Android SDK组件
  打开Android Studio的SDK Manager，确保安装了：

  • 项目编译目标对应的Android SDK Platform
  • 匹配AGP版本的Android SDK Build-Tools
  • 最新版Android SDK Command-line Tools

• 排查依赖冲突
  暂时移除最近新增的第三方Native库，重新构建项目，确认是否是依赖冲突导致的问题

• 获取详细堆栈信息定位根源
  执行命令获取完整错误堆栈，定位具体出错的依赖或配置：

  npx react-native run-android --stacktrace
  

内容的提问来源于stack exchange，提问作者Caio