NodeJS Express应用本地正常部署Heroku后非根路由报503错误如何解决

排查解决步骤 #

1. 修正MongoDB连接配置读取方式
   Heroku 不支持手动通过 heroku run bash 创建 .env 文件存储环境变量，这种方式创建的文件是临时的，dyno 重启后就会消失，且运行时无法被应用读取。你需要通过 Heroku 官方配置变量功能设置连接串：

heroku config:set MONGODB_URI=你的云MongoDB完整连接地址

2. 排查云MongoDB访问限制
   如果你使用的是 MongoDB Atlas 这类托管MongoDB服务，默认开启了IP白名单限制，需要在云数据库后台将 0.0.0.0/0 加入白名单，允许所有IP访问，否则Heroku的动态服务器IP会被拒绝连接，导致数据库请求超时返回503。

3. 添加数据库连接错误日志，定位具体问题
   你当前代码没有监听MongoDB连接的错误状态，根路径不涉及数据库操作所以能正常访问，访问 /token 等路径需要查询数据库，连接失败就会导致请求挂起超时。修改mongoose连接代码增加日志输出：

mongoose.connect(process.env.MONGODB_URI, {
    useNewUrlParser: true,
    useUnifiedTopology: true,
})
.then(() => console.log("MongoDB连接成功"))
.catch(err => console.error("MongoDB连接失败:", err));

修改部署后，执行 heroku logs --tail 查看运行日志，就能明确看到是不是数据库连接导致的问题。

4. 修正代码笔误
   你代码里 app.use(express.urlencoded({ extends:true })); 参数拼写错误，正确应为 extended: true，虽然这个不是导致503的核心问题，但会触发运行警告，建议修正。

5. 冗余配置清理
   app.yaml 是 Google App Engine 平台的配置文件，Heroku 完全不识别该配置，对你的问题没有帮助，可以直接删除。你的 package.json 中 main 字段写的是 index.js，但实际入口是 app.js，建议同步修改为 app.js 避免后续出现启动异常。

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