Flutter应用初始化Firebase Functions时遇EBADENGINE npm错误

问题详情 #

执行firebase init functions初始化Firebase Functions时，npm抛出EBADENGINE警告，提示当前Node.js版本（v20.11.1）不匹配要求的Node.js 18版本，完整日志如下：

? What language would you like to use to write Cloud Functions? JavaScript
? Do you want to use ESLint to catch probable bugs and enforce style? Yes
✔  Wrote functions/package.json
✔  Wrote functions/.eslintrc.js
✔  Wrote functions/index.js
✔  Wrote functions/.gitignore
? Do you want to install dependencies with npm now? Yes
npm WARN EBADENGINE Unsupported engine {
npm WARN EBADENGINE   package: undefined,
npm WARN EBADENGINE   required: { node: '18' },
npm WARN EBADENGINE   current: { node: 'v20.11.1', npm: '10.2.4' }
npm WARN EBADENGINE }

added 590 packages, and audited 591 packages in 32s

67 packages are looking for funding
  run `npm fund` for details

found 0 vulnerabilities

i  Writing configuration info to firebase.json...
i  Writing project information to .firebaserc...
i  Writing gitignore file to .gitignore...

✔  Firebase initialization complete!

重现步骤：删除项目server文件夹内所有内容后，重新执行firebase init functions即可触发该警告。

已尝试的无效方案 #

• 卸载并重新安装Node.js
• 修改package.json和package-lock.json中的engine版本为20，但修改后会自动恢复为18
• 查找StackOverflow相关解决方案

可行解决方案 #

方案1：使用nvm切换到Node.js 18环境（推荐） #

由于Firebase Functions模板默认要求Node.js 18，通过nvm管理Node版本可以完美匹配要求：

1. 安装nvm（MacOS可通过brew install nvm完成安装）
2. 在项目根目录执行nvm install 18安装Node.js 18版本
3. 切换到Node.js 18环境：nvm use 18
4. 重新执行firebase init functions，此时npm会使用Node.js 18，不会触发EBADENGINE警告

方案2：手动修改package.json后再安装依赖 #

避免firebase CLI自动覆盖package.json的引擎配置：

1. 执行firebase init functions，当出现Do you want to install dependencies with npm now?的提问时，选择No
2. 进入server（或functions）文件夹，编辑package.json，将engines字段修改为：

"engines": {
  "node": "20"
}

3. 在该文件夹内执行npm install，完成依赖安装

注意：修改后需在Firebase控制台的Functions设置中，将运行时版本切换为Node.js 20，确保部署后的函数能正常运行。

方案3：强制npm忽略引擎检查 #

如果只是想跳过警告继续安装，可手动执行带参数的npm安装命令：

1. 执行firebase init functions时选择不自动安装依赖
2. 进入server文件夹，执行：

npm install --force

或：

npm install --engine-strict=false

此方法会强制npm忽略引擎版本不匹配的警告，但可能存在潜在兼容性风险，仅作为临时应急方案使用。

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