You need to enable JavaScript to run this app. React Expo项目安装Firebase时出现npm EPERM权限报错
优惠活动
大模型
产品
解决方案
定价
更多

React Expo项目安装Firebase时出现npm EPERM权限报错

报错核心判定

本次抛出的EPERM: operation not permitted错误和Firebase包本身的兼容性无关,是Windows环境下npm操作的典型文件拦截问题,触发逻辑是npm尝试对node_modules下的ascli包做重命名升级操作时,目标文件被其他进程持有读写锁,直接被操作系统拒绝操作。
从你提供的项目路径(位于OneDrive同步目录下)判断,大概率是OneDrive的实时同步进程、代码编辑器的文件索引、杀毒软件的实时扫描三类进程共同导致的文件锁冲突。

分步解决操作流程
  • 第一阶段:解除所有可能的文件占用
    • 完全关闭正在运行的VS Code、WebStorm等代码编辑器(编辑器会主动索引node_modules下的文件,极易触发文件占用)
    • 退出后台运行的OneDrive客户端(项目路径属于OneDrive自动同步范围,同步进程会持续扫描、读写node_modules内的大量小文件,直接打断npm的重命名操作)
    • 临时暂停第三方杀毒软件、Windows Defender的实时文件防护(安全软件会拦截npm对node_modules内文件的删除、重命名操作)
  • 第二阶段:清理残留锁文件与缓存
    • 手动进入项目的node_modules目录,找到报错提及的ascli文件夹,直接手动删除;如果删除时提示文件占用,重启电脑后第一时间进入目录删除,不要提前启动OneDrive、代码编辑器等会触发文件扫描的进程
    • 以管理员权限打开终端,执行npm缓存强制清理命令:
      npm cache clean --force
  • 第三阶段:优化项目目录环境
    • 右键点击项目根文件夹,选择「属性-安全」选项,确认当前Windows登录用户对该目录及所有子文件夹拥有「完全控制」权限,若权限缺失,手动为当前用户添加对应权限
    • 从长期稳定角度建议:将项目从OneDrive同步目录下移到纯本地非同步路径(例如C:\DevProjects\Expo\insta),从根源上避免OneDrive同步带来的依赖安装、文件修改类报错
  • 第四阶段:重新执行依赖安装
    • 保持管理员终端的工作路径切换到项目根目录
    • 先执行旧依赖与锁文件的清理操作:
      • 如果用PowerShell终端:Remove-Item -Recurse -Force node_modules, package-lock.json
      • 如果用CMD终端:rmdir /s /q node_modules && del package-lock.json
    • 最后执行Expo官方依赖匹配安装命令,自动安装和SDK40兼容的Firebase版本:
      expo install firebase
安装完成后的注意事项
  • 当前使用的是Expo SDK 40(2020年发布的旧版本),安装完成的Firebase为适配该SDK的历史版本,不要手动执行npm install firebase@latest升级到最新版,否则会出现模块导出不匹配、运行时崩溃的问题
  • 因使用Expo托管开发流程,安装完成后无需手动修改原生配置文件,直接在项目入口文件完成Firebase初始化代码即可正常调用能力

内容的提问来源于stack exchange,提问作者Jupun Supun

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 06:06:05