应用上传到Heroku后如何正确连接MongoDB Atlas数据库

你遇到的两个报错是同一原因触发的连锁问题：应用在Heroku上没有成功建立数据库连接，才会先抛出Mongoose查询缓冲超时，后续路由拿不到todos值直接传给模板，导致EJS遍历undefined时报TypeError，不需要单独修改查询语句或者模板逻辑，按以下步骤排查即可。

第一步：核对连接串的环境变量配置 #

• 不要只在Heroku上配置MONGO_SERVER_PASSWORD单值，要直接把本地跑通的完整MongoDB连接串作为独立的Config Var存在Heroku上，避免拼接连接串时漏写参数、写错地址。本地可用的完整连接串格式为：mongodb+srv://<数据库用户名>:<数据库密码>@<集群地址>/<业务库名>?retryWrites=true&w=majority
• 重点核对连接串里的业务库名是否和本地一致：很多人拼接连接串时漏写了斜杠后面的库名，连接默认进到test库，自然找不到todotitles集合，就算连上也读不到数据。
• Heroku修改完Config Var之后，必须重启对应dyno或者重新部署应用才能生效，光改配置不重启，旧进程还是读的旧环境变量。可以在连接逻辑里临时加一行打码日志，把最终拼接出的连接串输出到Heroku日志，和本地跑通的串逐字对比，排除多打空格、漏写参数的问题。

第二步：检查MongoDB Atlas的网络白名单规则 #

• 这是本地能连、Heroku连不上的最高发原因：Atlas默认会拦截所有不在白名单内的来源IP，你之前配置的白名单一般只加了本地网络的出口IP，Heroku的动态出口IP完全不在规则里，请求会被Atlas直接拦截。
• 打开Atlas的Network Access配置页，添加允许所有IP访问的规则0.0.0.0/0，保存后等待1分钟规则生效即可。如果担心安全问题，只要数据库账号配置强密码，这种配置对小型待办应用来说风险极低，远好于因为IP限制频繁出现连接失败的问题。

第三步：调整Mongoose连接的基础配置 #

• 很多人的连接代码没加失败捕获，连接建立失败时没有直接打出错误，只在10s查询缓冲超时的时候才抛错。把连接逻辑改成标准写法，拉长超时阈值适配Heroku的网络延迟：

mongoose.connect(process.env.MONGODB_URI, {
  useNewUrlParser: true,
  useUnifiedTopology: true,
  serverSelectionTimeoutMS: 30000 // 将默认10s的服务选择超时拉长到30s，适配Heroku的网络波动
})
.then(() => console.log("MongoDB Atlas连接成功"))
.catch(err => console.log("数据库连接失败：", err.message))

• 额外核对集合名的大小写：MongoDB对集合名严格区分大小写，比如本地建的集合名是TodoTitles，代码里如果写的是todotitles，就算连接成功也读不到对应集合的数据。

第四步：通过Heroku日志定位真实错误 #

• 不要盯着前端的模板报错反向猜问题，直接在本地终端执行heroku logs --tail，实时拉取应用日志，刷新页面后查看真实的连接报错：
  • 如果日志报MongoServerError: Authentication failed，说明连接串里的用户名、密码和Atlas配置不匹配
  • 如果日志报MongoNetworkError: connection timed out，说明Atlas的白名单规则没生效，Heroku的请求被拦截
  • 如果日志报ns not found，说明连接串里的库名写错，没有进到正确的业务库

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