安装react-native-appsflyer后React Native项目遇EPERM权限错误

问题描述 #

此前项目运行正常，安装react-native-appsflyer依赖后无法启动，触发以下权限错误：

> Task :react-native-reanimated:configureCMakeDebug[arm64-v8a]
node:internal/process/promises:289
            triggerUncaughtException(err, true /* fromPromise */);
            ^

Error: EPERM: operation not permitted, lstat 'C:\Users\glebb\Desktop\mately\bemate_app\node_modules\react-native-reanimated\android\build\intermediates\cxx\Debug\q303t1s5\obj\arm64-v8a\libworklets.so.tmp6455ceb'
Emitted 'error' event on NodeWatcher instance at:
    at C:\Users\glebb\Desktop\mately\bemate_app\node_modules\@react-native-community\cli\node_modules\metro-file-map\src\watchers\NodeWatcher.js:231:14 {
  errno: -4048,
  code: 'EPERM',
  syscall: 'lstat',
  path: 'C:\\Users\\glebb\\Desktop\\mately\\bemate_app\\node_modules\\react-native-reanimated\\android\\build\\intermediates\\cxx\\Debug\\q303t1s5\\obj\\arm64-v8a\\libworklets.so.tmp6455ceb'
}

Node.js v20.12.2

额外异常：报错后不重启电脑无法删除node_modules文件夹，需管理员权限。

已尝试方案及结果 #

曾通过视频方案解决过类似问题，但本次无效。已尝试Stack Overflow相关问题中的所有方案：

• 清理缓存重启服务：在Android Studio执行File>Invalidate Caches/Restart，终止本地服务后运行npx react-native start --reset-cache和npm run android，结果触发react-native-webview编译错误：

  C:\Users\glebb\Desktop\mately\bemate_app\node_modules\react-native-webview\android\src\main\java\com\reactnativecommunity\webview\RNCWebViewClient.java:314: error: cannot find symbol
          event.putDouble("target", RNCWebViewWrapper.getReactTagFromWebView(webView));
                                    ^
    symbol:   variable RNCWebViewWrapper
    location: class RNCWebViewClient
  Note: Some input files use or override a deprecated API.
  Note: Recompile with -Xlint:deprecation for details.
  100 errors
  only showing the first 100 errors, of 112 total; use -Xmaxerrs if you would like to see more
  
  FAILURE: Build completed with 2 failures.
  
  1: Task failed with an exception.
  -----------
  * What went wrong:
  Execution failed for task ':react-native-webview:compileDebugJavaWithJavac'.
  > Compilation failed; see the compiler error output for details.
  

• 清理Gradle缓存：执行cd android && ./gradlew clean && cd .. && npx react-native run-android，结果仍出现与:react-native-reanimated:buildCMakeDebug[arm64-v8a]相关的权限错误。

解决方案 #

解决EPERM权限错误 #

• 管理员身份运行终端：关闭所有相关进程（Node、Android Studio、模拟器），右键终端选择「以管理员身份运行」，再执行构建命令。
• 解除文件占用：用Process Explorer工具查找占用libworklets.so.tmp6455ceb文件的进程，结束进程后再尝试删除node_modules或重新构建。
• 调整文件夹权限：右键项目根文件夹→属性→安全→编辑，给当前用户添加「完全控制」权限，应用后重新安装依赖。

解决react-native-webview编译错误 #

• 版本适配检查：确认react-native-webview版本与当前React Native版本兼容，降级或升级到匹配版本。
• 重装webview依赖：

  npm uninstall react-native-webview
  npm install react-native-webview@适配版本
  cd android && ./gradlew clean
  

• 同步Gradle依赖：在Android Studio中点击File>Sync Project with Gradle Files，同步完成后再构建。

终极排查流程 #

1. 重启电脑后删除node_modules、android/build文件夹。
2. 清除npm缓存：npm cache clean --force。
3. 重新安装依赖：npm install。
4. 以管理员身份启动终端，执行npx react-native run-android。

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