本地运行正常的Express.js应用部署Netlify/Vercel/Render失败排查

本地运行完全正常的Express.js应用，按照官方文档和教程部署到Netlify、Vercel、Render平台均失败，怀疑是代码问题。尝试多个易部署平台仍未解决，代码逻辑简单却无法定位问题，请求帮忙排查代码中的问题。

相关代码文件 #

server.js #

const dotenv = require('dotenv').config({ path: 'config.env' });
const http = require('http');
const mongoose = require('mongoose');
const app = require('./app');
// connection to DB
const DB = process.env.DATABASE.replace(
  '<password>',
  process.env.DATABASE_PASSWORD
);

mongoose
  .connect(DB, {
    dbName: 'JSQuiz',
    useNewUrlParser: true,
    useCreateIndex: true,
    useFindAndModify: false,
    useUnifiedTopology: true
  })
  .then(() => console.log('DB connection successful!'));

const port = process.env.PORT;

const server = http.createServer(app);

server.listen(port, () => {
  console.log(`App running on port ${port}...`);
});

package.json #

{
  "name": "server",
  "version": "1.0.0",
  "engines": {
    "node": "18.x"
  },
  "description": "Server for Vue app",
  "main": "server.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
}

app.js（部分代码省略） #

const homeRouter = require('./routes/homeRoutes');
const routers = [...homeRouter...]
routers.forEach(router => {
  app.use('/api/v1', router);
});

排查出的关键问题点 #

• 缺少启动脚本：package.json的scripts中没有start命令，部署平台无法识别启动方式，需添加："start": "node server.js"
• 环境变量依赖本地文件：dotenv指定了本地config.env路径，部署平台中该文件可能未被正确上传，建议改用平台自带的环境变量管理功能，移除对本地配置文件的依赖
• Mongoose过时选项：代码中使用的useCreateIndex、useFindAndModify是Mongoose 6.x版本已废弃的选项，Node 18对应的Mongoose版本较高，这些选项会触发报错，需删除这些配置项
• 路由数组语法错误：const routers = [...homeRouter...]语法错误，homeRouter是单个路由对象，无需展开，应改为const routers = [homeRouter]
• 未处理数据库连接错误：mongoose.connect只处理了成功回调，未捕获连接失败的错误，部署时数据库连接失败会导致应用直接崩溃，需添加.catch(err => console.error('DB connection failed:', err))

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