部署在Vercel的Express-MongoDB服务器API无法访问问题排查

1. Vercel路由转发配置错误（最常见原因） #

Vercel不会默认把所有请求转发到你的Express服务器，必须在vercel.json里配置rewrites规则，将所有API路由请求指向Express入口文件。如果配置缺失或路径错误，就会出现除根路径外的路由404。

正确配置示例：

{
  "rewrites": [
    { "source": "/(.*)", "destination": "/index.js" }
  ]
}

注意：如果Express入口文件在子目录（比如src/index.js），需要把destination修改为对应路径。

2. Express路由注册顺序问题 #

检查index.js里的路由注册顺序：必须先注册API路由（/cars、/reviews），再注册根路径，且要确保路由不会被前置的中间件拦截。示例代码结构：

const express = require('express');
const app = express();

// 先加载必要中间件
app.use(express.json());

// 再注册API路由
app.use('/cars', require('./routes/cars'));
app.use('/reviews', require('./routes/reviews'));

// 最后注册根路径
app.get('/', (req, res) => {
  res.send('Server running');
});

app.listen(process.env.PORT || 3000);

如果API路由被放在根路径之后，或被错误的中间件（比如提前的错误处理中间件）拦截，也会导致无法访问。

3. Vercel入口文件识别错误 #

确认package.json的start脚本指向正确的入口文件：

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

如果入口文件在子目录（比如src/index.js），脚本要改成node src/index.js，否则Vercel启动服务器时会加载不到正确的路由配置。

4. 项目结构冲突 #

Vercel的Serverless Functions模式（路由放在api目录下）和完整Express服务器模式不能混用。如果你同时存在api目录和Express全局服务器，会导致路由规则冲突，优先触发Serverless函数逻辑，从而找不到Express里的/cars、/reviews路由。

5. MongoDB连接隐性错误（非404但可能被误判） #

虽然根路径能访问，但API路由依赖MongoDB连接时，连接失败可能返回500错误而非404，容易被误判为路由不存在。可以在API路由里添加日志排查：

app.get('/cars', async (req, res) => {
  try {
    // 测试MongoDB连接状态
    await mongoose.connection.db.admin().ping();
    const cars = await Car.find();
    res.json(cars);
  } catch (err) {
    console.error('数据库连接/查询错误:', err);
    res.status(500).send('服务器内部错误');
  }
});

然后在Vercel控制台查看函数日志，确认是否存在数据库连接问题。

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