为什么我的Node应用连接MongoDB Atlas时Heroku抛出503错误？

首先对报错信息做定位：

2021-11-20T11:44:40.554636+00:00 heroku[router]: at=error code=H12 desc="Request timeout" method=GET path="/admin" host=log-store-api.herokuapp.com request_id=f5c13cb1-3e75-4767-8c41-9abd02dcfded fwd="47.11.229.75" dyno=web.1 connect=0ms service=30000ms status=503 bytes=0 protocol=https

该报错为Heroku平台的H12请求超时错误，触发条件是请求进入服务后30秒没有返回响应，结合你连接MongoDB Atlas的场景，本质是数据库连接阻塞无响应，按以下优先级排查即可：

1. 检查MongoDB Atlas IP白名单配置 #

• MongoDB Atlas默认拦截所有不在白名单内的IP访问，这是该场景下最常见的问题，你需要确认是否将Heroku的出口IP段加入了Atlas的IP白名单
• 可临时开启允许所有IP访问测试连接是否恢复，验证是白名单问题后再按需配置固定IP段即可

2. 检查数据库连接串配置 #

• 确认Heroku后台配置的MONGODB_URI等环境变量参数正确，包括用户名、密码、集群地址、目标数据库名称，注意密码中的特殊字符需要做URL编码
• 可在本地环境使用相同的连接串测试连接，排除连接串本身的语法错误问题

3. 检查Node代码的连接逻辑 #

• 确认代码中添加了MongoDB连接的错误捕获逻辑，避免连接异常时请求直接挂住无返回，参考示例：

mongoose.connect(process.env.MONGODB_URI)
  .then(() => console.log("数据库连接成功"))
  .catch(err => {
    console.error("数据库连接失败:", err)
    // 连接异常时主动返回错误，避免请求挂住触发超时
  })

• 确认数据库连接逻辑是放在服务启动阶段全局初始化，没有写在请求处理函数内部导致每次请求都重复发起连接，大幅提升超时概率

4. 查看服务运行日志定位细节 #

• 可通过Heroku CLI执行heroku logs --tail查看服务启动阶段、请求触发时的完整日志，直接读取MongoDB连接抛出的具体错误信息，快速定位问题
• 如果你使用了Heroku的Private Space等专有网络配置，需要确认对应网络的出口规则允许访问MongoDB Atlas的服务地址

5. 测试用优化配置（仅用于排查） #

可以给MongoDB连接主动设置小于30秒的超时时间，避免直接触发Heroku的H12超时，方便捕获具体错误：

mongoose.connect(process.env.MONGODB_URI, {
  connectTimeoutMS: 10000,
  socketTimeoutMS: 20000
})

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