React Native npx初始化失败：找不到gradle.properties文件

问题重现 #

执行npx react-native@latest init MyAwesomeProject初始化项目时，模板下载完成后复制阶段报错，提示：

/home/bedena/.npm/_npx/dea611a43221eddd/node_modules/graceful-fs/polyfills.js:265
if (!chownErOk(er)) throw er
^

Error: ENOENT: no such file or directory, chmod '/home/bedena/Desktop/programming/nativereactbootcamp/MyAwesomeProjectInit/android/gradle.properties'

项目文件夹已创建但内部为空，无法正常运行。

解决步骤 #

• 清理残留与缓存

  1. 删除已创建的空项目目录：

     rm -rf /home/bedena/Desktop/programming/nativereactbootcamp/MyAwesomeProjectInit
     

  2. 清理npm缓存：

     npm cache clean --force
     

  3. 删除npx临时缓存目录：

     rm -rf ~/.npm/_npx
     

• 修复目录权限
  确保项目父目录有足够的读写权限：

  sudo chown -R $USER:$USER /home/bedena/Desktop/programming/nativereactbootcamp
  chmod -R 755 /home/bedena/Desktop/programming/nativereactbootcamp
  

• 换用指定版本初始化
  避免最新版模板的潜在bug，手动创建目录后指定稳定版本初始化：

  mkdir MyAwesomeProjectInit && cd MyAwesomeProjectInit
  npx react-native@0.72.0 init .
  

  如果需要TypeScript模板，添加--template react-native-template-typescript参数。

• 临时禁用graceful-fs polyfill
  部分情况下graceful-fs的polyfill会导致文件权限问题，初始化前设置环境变量：

  export GRACEFUL_FS_NO_POLYFILL=1
  npx react-native@latest init MyAwesomeProject
  

• 验证环境配置

  1. 确认JDK版本符合要求（React Native 0.70+需JDK 11）：

     java -version
     

  2. 检查Android SDK路径是否正确配置：

     echo $ANDROID_HOME
     

     确保输出指向Android Studio的SDK安装目录（通常是~/Android/Sdk）。

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