Heroku部署推送失败，npm依赖锁文件同步报错如何解决？

根本原因 #

fs是Node.js内置的核心模块，不需要手动在package.json的依赖项中声明。你项目的package.json里写了fs@*的依赖声明，而npm官方仓库的fs包仅为0.0.1-security的占位提示包，和你声明的*版本要求不匹配，最终导致lock文件校验失败。

修复步骤 #

• 打开项目根目录的package.json文件，删除dependencies或devDependencies中"fs": "*"这一行配置
• 清理本地旧依赖与缓存，执行以下命令：

  # 删除本地依赖目录
  rm -rf node_modules
  # 删除旧lock文件
  rm package-lock.json
  # 清理npm全局缓存
  npm cache clean --force
  

  Windows系统对应执行：

  rmdir /s /q node_modules
  del package-lock.json
  npm cache clean --force
  

• 重新安装依赖生成新的lock文件：npm install
• 必须将新生成的package-lock.json提交到Git仓库，Heroku部署时会拉取你仓库内的文件，未提交的修改不会被识别
• 重新推送代码到Heroku即可：git push heroku main（主分支名为master则替换为master）

可选兼容配置 #

如果执行完上述步骤仍有环境差异问题，可在package.json中添加engines字段，指定和你本地一致的Node.js、npm版本，避免版本差异导致的lock文件不兼容：

{
  "engines": {
    "node": "你的本地Node版本，比如16.x",
    "npm": "你的本地npm版本，比如8.x"
  }
}

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