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内文件的删除、重命名操作)
- 完全关闭正在运行的VS Code、WebStorm等代码编辑器(编辑器会主动索引
- 第二阶段:清理残留锁文件与缓存
- 手动进入项目的
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
- 如果用PowerShell终端:
- 最后执行Expo官方依赖匹配安装命令,自动安装和SDK40兼容的Firebase版本:
expo install firebase
安装完成后的注意事项
- 当前使用的是Expo SDK 40(2020年发布的旧版本),安装完成的Firebase为适配该SDK的历史版本,不要手动执行
npm install firebase@latest升级到最新版,否则会出现模块导出不匹配、运行时崩溃的问题 - 因使用Expo托管开发流程,安装完成后无需手动修改原生配置文件,直接在项目入口文件完成Firebase初始化代码即可正常调用能力
内容的提问来源于stack exchange,提问作者Jupun Supun
相关产品推荐
相关产品推荐

