升级系统后Firebase部署报错：找不到模块./commands/run-script.js

DevOps 小满

2026-7-10

解决方案：Firebase云函数部署报错Cannot find module './commands/run-script.js'

清理缓存并重装项目依赖
执行以下命令彻底重置本地依赖环境：
```
npm cache clean --force
rm -rf node_modules package-lock.json
npm install
```
清除损坏的缓存和依赖文件后，重新构建依赖树，修复可能的文件路径异常。
重新安装对应版本的npm
报错指向npm内部文件缺失，大概率是npm安装不完整。执行命令重装当前版本的npm：
```
npm install -g npm@9.6.7
```
安装完成后可通过npm ls npm查看npm安装路径，检查该路径下lib/commands目录是否存在run-script.js文件。
更新Firebase CLI至最新版
旧版CLI可能与当前node/npm版本存在兼容性问题，更新到最新版本：
```
npm install -g firebase-tools
```
验证版本后重新执行部署命令：firebase deploy --only functions
用nvm重新安装指定node版本
系统升级可能导致node环境损坏，通过nvm重新安装配套的node版本：
```
nvm install 18.17.1
nvm use 18.17.1
```
切换版本后重新安装项目依赖再尝试部署。
检查自定义预部署脚本
查看项目及functions目录下package.json的scripts字段，确认是否有预部署脚本错误调用了run-script相关命令，修正路径或逻辑。