Node API部署至Heroku遇异常：本地正常线上无法访问

结合你描述的情况（本地正常，Heroku构建成功但访问出错），我整理了几个关键排查点，按优先级来：

1. 紧急修复：调整app.listen的位置 #

看你的app.js代码，你把app.listen()放在了路由定义之前！这会导致Express启动服务器后，后续的路由（包括根路由和/wedding）都不会被注册，访问自然会返回错误。

错误代码顺序：

app.listen(PORT, () => { console.log(`Listening on port ${PORT}`); })
// 之后才定义路由
app.get('/', (req, res) => { res.send('hello we are deployed'); });
app.use('/wedding', weddingRoutes);

正确的顺序应该是：先定义所有中间件和路由，最后启动服务器：

// 所有中间件、路由定义放在前面
app.get('/', (req, res) => { res.send('hello we are deployed'); });
const weddingRoutes = require('./routes/weddingRoutes');
app.use('/wedding', weddingRoutes);

// 最后启动服务器
app.listen(PORT, () => { console.log(`Listening on port ${PORT}`); })

这个问题是本地可能因为缓存或重启时的加载顺序侥幸正常，但Heroku上严格按代码顺序执行，肯定会出问题。先改这个，重新部署试试。

2. 查看Heroku日志获取具体错误 #

Heroku的默认错误页面不会显示具体问题，你必须通过日志排查：
在本地终端运行：

heroku logs --tail

这个命令会实时输出应用的日志，你刷新错误页面后，就能看到具体的报错信息（比如数据库连接失败、环境变量缺失等），这是定位问题的核心。

3. 环境变量配置问题 #

你用了dotenv加载本地的.env文件，但Heroku不会读取这个文件。如果你的数据库连接字符串（比如DATABASE_URL）是存在本地.env里的，必须在Heroku上手动配置：

• 方法1：登录Heroku仪表盘，进入你的应用 → 设置 → 找到「Config Vars」，添加对应的键值对（比如DATABASE_URL=你的PSQL连接字符串）
• 方法2：在本地终端运行：

  heroku config:set DATABASE_URL="你的数据库连接字符串"
  

4. 修复package.json里的小问题 #

你的engines字段里，npm版本前面多了一个空格：

"npm": " 5.5.1"

改成：

"npm": "5.5.1"

虽然这个不一定直接导致错误，但可能影响Heroku的依赖安装流程，建议修正。

5. 数据库访问权限检查 #

如果你的/wedding路由连接的是外部PSQL数据库（不是Heroku提供的Postgres插件），需要确保：

• 数据库允许远程连接（比如修改Postgres的pg_hba.conf配置）
• 数据库的防火墙允许Heroku的IP段访问（或者暂时开放所有IP测试，但生产环境不要这么做）

先按上面的步骤逐一排查，尤其是调整app.listen的位置，这大概率是导致你当前错误的原因。

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