Firebase部署时npm包安装失败，package与lock文件不同步的潜在原因

本地构建、模拟运行无代码相关报错，但部署Firebase Hosting时触发npm ci报错，提示package.json与package-lock.json不同步，具体报错信息如下：

Build failed: npm ERR! code EUSAGE
npm ERR!
npm ERR! `npm ci` can only install packages when your package.json and package-lock.json or npm-shrinkwrap.json are in sync. Please update your lock file with `npm install` before continuing.
npm ERR!
npm ERR! Missing: @firebase/app-compat@0.2.13 from lock file
npm ERR! Missing: @firebase/app@0.9.13 from lock file
npm ERR! Missing: @firebase/component@0.6.4 from lock file
npm ERR! Missing: @firebase/logger@0.4.0 from lock file
npm ERR! Missing: @firebase/util@1.9.3 from lock file
npm ERR! Missing: tslib@2.6.0 from lock file
npm ERR! Missing: @firebase/component@0.6.4 from lock file
npm ERR! Missing: @firebase/logger@0.4.0 from lock file
npm ERR! Missing: @firebase/util@1.9.3 from lock file
npm ERR! Missing: idb@7.1.1 from lock file
npm ERR! Missing: tslib@2.6.0 from lock file
npm ERR!
npm ERR! Clean install a project
npm ERR!
npm ERR! Usage:
npm ERR! npm ci
npm ERR!
npm ERR! Options:
npm ERR! [-S|--save|--no-save|--save-prod|--save-dev|--save-optional|--save-peer|--save-bundle]
npm ERR! [-E|--save-exact] [-g|--global] [--global-style] [--legacy-bundling]
npm ERR! [--omit <dev|optional|peer> [--omit <dev|optional|peer> ...]]
npm ERR! [--strict-peer-deps] [--no-package-lock] [--foreground-scripts]
npm ERR! [--ignore-scripts] [--no-audit] [--no-bin-links] [--no-fund] [--dry-run]
npm ERR! [-w|--workspace <workspace-name> [-w|--workspace <workspace-name> ...]]
npm ERR! [-ws|--workspaces] [--include-workspace-root] [--install-links]
npm ERR!
npm ERR! aliases: clean-install, ic, install-clean, isntall-clean
npm ERR!
npm ERR! Run "npm help ci" for more info

npm ERR! A complete log of this run can be found in:
npm ERR!     /www-data-home/.npm/_logs/2023-06-30T16_26_12_626Z-debug-0.log; Error ID: beaf8772

已知情况：本地执行npm i/npm ci无法同步两个文件，同事推送的lock文件可正常部署，但自己执行npm i/npm ci后会移除lock文件中的相关条目；报错日志提及的文件路径本地不存在；已同步package文件，使用Node.js 16.16.0、npm 8.11.0，更新全局npm无效。

潜在原因 #

• npm配置或子版本差异：虽然Node.js版本一致，但npm 8.x的子版本可能对lock文件的解析/生成逻辑有细微调整，或者本地有特殊配置（比如package-lock=false、save-exact等），导致执行安装时修改了lock文件内容。
• 本地依赖缓存干扰：本地npm缓存中存在旧版本依赖，导致安装时跳过部分依赖的写入，或者依赖树解析结果与同事的全新环境不一致，进而修改lock文件。
• 本地.npmrc配置差异：若本地存在未提交的.npmrc，其中的镜像源、依赖忽略规则、lock文件版本配置等，会影响依赖安装时的lock文件生成逻辑，和同事的环境产生差异。
• 本地链接依赖影响：如果本地使用了npm link引入依赖，会导致lock文件中对应的条目被移除，和仓库中的lock文件不一致。
• Firebase构建环境校验严格：Firebase Hosting的构建环境强制使用npm ci做严格校验，本地修改后的lock文件不符合其依赖树要求；另外报错中的日志路径是构建容器内的路径，本地无法访问属于正常情况。

排查建议 #

• 清理本地环境后重新匹配：执行rm -rf node_modules package-lock.json，从仓库拉取同事的lock文件，再执行npm ci（不要用npm i），确保本地依赖完全匹配lock文件。
• 对比npm配置：执行npm config list，查看package-lock、save、save-exact等配置项，和同事的配置做对比，排除配置差异。
• 检查.npmrc文件：确认本地.npmrc的配置（如registry、lockfileVersion）和团队一致，若有特殊配置需同步到仓库或调整。
• 用全新环境验证：比如使用Docker拉取node:16.16.0镜像，在容器内安装依赖，看是否会修改lock文件，排除本地环境的干扰。

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