Heroku部署Node.js应用提示Cannot find module 'mongoose'报错如何解决

该报错的核心原因是Heroku部署环境中缺少项目依赖的mongoose模块。Heroku部署Node.js项目时，只会安装package.json的dependencies字段下声明的生产依赖包，出现该错误通常有两种场景：

• 本地开发时安装mongoose没有加--save参数，没有将依赖写入package.json
• mongoose被误写入devDependencies字段，Heroku默认部署时不会安装开发依赖包

按照以下步骤操作即可解决问题：

1. 在本地项目根目录执行命令，将mongoose加入生产依赖：

npm install mongoose --save

2. 检查package.json文件，确认mongoose已经出现在dependencies字段下，你当前配置的npm start启动命令符合Heroku要求，无需调整
3. 确认.gitignore文件中已经添加了node_modules/规则，不要将本地依赖包提交到Git仓库，避免和Heroku自动安装的依赖产生冲突
4. 将修改后的package.json和package-lock.json提交到Git仓库，重新推送到Heroku即可完成部署

包含大量路由的Node.js应用完全可以通过该方式部署到Heroku，部署时注意以下事项即可保证运行稳定：

• 所有生产环境变量（比如数据库连接地址、加密密钥、第三方服务密钥等）不要硬编码在代码中，统一在Heroku后台的配置变量板块设置
• 如果使用MongoDB数据库，需要开放Heroku的IP访问权限，更推荐使用MongoDB Atlas这类云数据库服务减少网络适配成本
• 若应用访问量较高，可以升级Heroku的dyno配置，或者开启多实例水平扩容满足性能需求
• Heroku免费版dyno会在30分钟无访问时自动休眠，若需要服务持续在线可以升级到付费套餐

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