部署至Heroku后Node.js Express应用异常，请求故障排查协助

我用Express、Mongoose和EJS开发了一个Node.js Web应用，本地运行正常，但部署到Heroku后无法连接MongoDB Atlas数据库，产品CRUD路由也未按预期工作，找不到问题根源，需要协助排查故障。

应用代码 #

const { urlencoded } = require("body-parser")
const express = require("express")
const mongoose = require('mongoose')
const app = express()
const Product = require('./models/product')
const methodOverride = require('method-override')

mongoose.connect("mongodb+srv://user:pass123@cluster0.avm9sgy.mongodb.net/?retryWrites=true&w=majority", { useNewUrlParser: true }
).then(() => console.log("Database Connection succesful")).catch(() => console.log("error"))

app.set('view engine', 'ejs')
app.use(express.urlencoded({ extended: true }))
app.use(methodOverride('_method'))

app.get('/', async (req, res) => {
    res.send('Hello')
})
app.get('/products', async (req, res) => {
    const products = await Product.find({})
    res.render('products/index', { products })
})
app.get('/products/new', async (req, res) => {
    res.render('products/new')
})

app.post('/products', async (req, res) => {
    const newProduct = new Product(req.body)
    await newProduct.save()
    console.log(newProduct)
    res.redirect(`products/${newProduct._id}`)
})

app.get('/products/:id', async (req, res) => {
    const { id } = req.params
    const product = await Product.findById(id)
    res.render('products/details', { product })
})

app.get('/products/:id/edit', async (req, res) => {
    const { id } = req.params
    const product = await Product.findById(id)
    res.render('products/edit', { product })
})

app.put('/products/:id', async (req, res) => {
    const { id } = req.params
    const product = await Product.findByIdAndUpdate(id, req.body, { runValidators: true, new: true })
    res.redirect(`/products/${product._id}`)
})

app.delete('/products/:id', async (req, res) => {
    const { id } = req.params
    const deletedProduct = await Product.findByIdAndDelete(id)
    res.redirect(`/products/`)
})

app.listen(3000)

排查步骤及修复方案 #

1. 数据库连接问题

• 移除硬编码凭证：代码中直接写死MongoDB连接字符串，Heroku环境下必须用环境变量存储敏感信息。
  • 在Heroku控制台「设置」-「配置变量」中添加MONGODB_URI，值为你的MongoDB Atlas连接字符串（替换实际用户名和密码）。
  • 修改连接逻辑：

    mongoose.connect(process.env.MONGODB_URI || "mongodb+srv://user:pass123@cluster0.avm9sgy.mongodb.net/?retryWrites=true&w=majority", { useNewUrlParser: true })
    .then(() => console.log("数据库连接成功"))
    .catch(err => console.log("数据库连接错误:", err))
    

• 检查Atlas IP白名单：MongoDB Atlas默认仅允许本地IP访问，需将Heroku服务器IP加入白名单，或临时设置为0.0.0.0/0（测试用，生产环境建议配置Heroku静态IP）。
• 完善错误日志：原代码catch块仅打印"error"，无法定位具体问题，修改后打印详细错误信息，通过heroku logs --tail命令查看实时日志。

2. 端口配置问题

Heroku会动态分配端口，不能固定监听3000，修改监听逻辑：

const port = process.env.PORT || 3000
app.listen(port, () => console.log(`服务器运行在端口 ${port}`))

3. 路由与路径问题

• 修复重定向路径：app.post('/products')中的重定向缺少开头的/，会导致相对路径跳转错误，修改为：

  res.redirect(`/products/${newProduct._id}`)
  

• 确认启动命令：确保package.json的scripts包含start命令，例如：

  "scripts": {
    "start": "node app.js"
  }
  

• 检查依赖配置：所有生产环境依赖（express、mongoose、ejs、method-override等）必须放在dependencies中，devDependencies中的包不会在Heroku生产环境安装。

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