运行React Native应用到实体设备时报Failed to run jetifier错误如何解决

报错信息：
error Failed to run jetifier.
Error: Command failed: C:\Users\Ashish Nath\Desktop\react native\AwesomeProject\node_modules@react-native-community\cli-platform-android\node_modules\jetifier\bin\jetify
at makeError (C:\Users\Ashish Nath\Desktop\react native\AwesomeProject\node_modules@react-native-community\cli-platform-android\node_modules\execa\index.js:174:9)
at C:\Users\Ashish Nath\Desktop\react native\AwesomeProject\node_modules@react-native-community\cli-platform-android\node_modules\execa\index.js:278:16
at processTicksAndRejections (node:internal/process/task_queues:96:5)
at async Object.runAndroid [as func] (C:\Users\Ashish Nath\Desktop\react native\AwesomeProject\node_modules@react-native-community\cli-platform-android\build\commands\runAndroid\index.js:104:7)
at async Command.handleAction (C:\Users\Ashish Nath\Desktop\react native\AwesomeProject\node_modules@react-native-community\cli\build\index.js:186:9)
info Run CLI with --verbose flag for more details.

排查解决步骤 #

1. 清理损坏的缓存与依赖 #

• 删除本地依赖文件与lock文件
  Windows PowerShell执行：
  rmdir /s /q node_modules; del package-lock.json yarn.lock
  Mac/Linux执行：
  rm -rf node_modules package-lock.json yarn.lock
• 重新安装依赖：npm install 或 yarn install
• 清理安卓构建缓存：进入项目android目录，执行
  Windows: gradlew.bat clean
  Mac/Linux: ./gradlew clean
• 重启RN服务并清理缓存：npx react-native start --reset-cache

2. 校验jetifier配置 #

• 检查package.json中是否存在jetifier依赖，缺失则手动安装：npm install jetifier --save-dev
• 手动执行jetify命令验证可用性：npx jetify，如果手动执行也报错，回到第一步重新安装依赖
• React Native 0.60+版本需确认android/gradle.properties中存在配置android.enableJetifier=true，且值为true

3. 排查系统环境问题 #

• 当前项目路径存在空格（C:\Users\Ashish Nath\Desktop\react native\包含两处空格），Windows下部分Node工具对带空格的路径兼容较差，可将项目移动到无空格的路径（例如C:\Projects\AwesomeProject）后重新运行
• 确认Node.js版本与之前正常运行时一致，若近期升级过Node，可回退到之前使用的LTS版本重试

4. 临时规避方案 #

如果以上步骤都无法解决，且项目所有安卓依赖已完成AndroidX迁移，可在运行命令中添加参数跳过jetifier执行：
npx react-native run-android --no-jetifier

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