Flutter应用部署Firebase Functions时Stripe模块依赖异常

问题根源 #

你遇到的问题核心是依赖安装目录错误导致package.json未添加Stripe依赖，后续手动修改又引发package.json与package-lock.json不一致，触发Firebase部署时的npm ci校验失败。

修复步骤 #

1. 切换到正确的Functions目录
   Firebase Functions的依赖必须安装在项目的functions子目录下，先进入该目录：

   cd functions
   

2. 彻底重置依赖环境
   删除旧的依赖文件，避免缓存或不一致问题：

   rm -rf node_modules package-lock.json
   

3. 重新安装所有依赖并添加Stripe
   先安装基础依赖，再明确添加Stripe到生产依赖：

   npm install
   npm install stripe --save
   

   执行完后检查functions/package.json，确认dependencies中已包含stripe条目。

4. 重新部署Functions
   回到项目根目录，执行部署命令：

   cd ..
   firebase deploy --only functions
   

关键注意点 #

• 永远不要在Firebase项目根目录执行npm install，必须进入functions目录操作，否则依赖不会被添加到Functions的package.json中。
• 手动修改package.json后，一定要重新生成package-lock.json（通过重新执行npm install），否则Firebase部署时的npm ci会因为锁文件与配置文件不一致而失败。

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