React Native执行gradlew clean失败：升级后项目配置报错

安全阿岳

2026-8-11

解决React Native 0.71.0-rc.1升级后gradlew clean配置失败问题

错误信息

1 configuration failure
A problem occurred configuring project ':app'.
Illegal character in authority at index 7: file://C:\Users\jains\OneDrive\Desktop[PROJECT-NAME]\node_modules\react-native\android

问题原因

错误核心是项目路径包含方括号[]，Gradle在解析file协议URL时，方括号属于非法字符。React Native 0.71.x版本的Gradle配置逻辑比0.64.x更严格，导致原本可正常运行的带特殊字符路径触发了解析错误。

解决方案

方案一：修改项目路径（优先推荐）
将项目从含[PROJECT-NAME]的目录迁移到无特殊字符（如[]、尽量避免空格）的路径下，例如改为C:\Users\jains\OneDrive\Desktop\PROJECT-NAME，之后重新执行gradlew clean。
方案二：临时转义路径中的方括号
若暂时无法移动项目，可在Gradle配置中转义方括号：找到项目根目录下的android/build.gradle或android/app/build.gradle，将涉及react-native路径里的[替换为%5B，]替换为%5D（即把[PROJECT-NAME]改成%5BPROJECT-NAME%5D）。此方法仅作临时应急，可能因RN版本迭代失效。
方案三：回退Gradle版本（不推荐）
若不想修改路径，可尝试将Gradle版本回退至0.64.x时期的版本，但会丢失RN 0.71.x的新特性，还可能引发其他兼容性问题，仅作为最后备选。