Vercel部署Express应用仅根路径可用，其他端点报500错误求助

核心问题定位 #

你的vercel.json重写规则配置错误，所有请求都被强制转发到根路径/，导致Express的其他路由无法接收请求，这是500错误的主要原因。

具体修复步骤 #

1. 修正vercel.json配置 #

将重写规则的destination改为指向你的Express入口文件，而不是根路径：

{
  "version": 2,
  "builds": [
    {
      "src": "./index.js",
      "use": "@vercel/node"
    }
  ],
  "rewrites": [
    {
      "source": "/(.*)",
      "destination": "/index.js"
    }
  ]
}

2. 调整Express入口的导出方式 #

Vercel的Node运行时要求导出Express实例，不能在代码中自行监听端口（本地测试可保留，但部署时需通过条件判断规避）：

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

// CORS配置
const corsOptions = {
  "origin": "*",
  "methods": "GET, HEAD, PUT, PATCH, POST, DELETE"
};
app.use(cors(corsOptions));

// 必须添加请求体解析中间件（处理POST/PUT等带请求体的请求）
app.use(express.json());
app.use(express.urlencoded({ extended: true }));

// 路由定义
app.get('/', (req, res) => {
  res.send('Hello World!');
});

app.post('/someEndpoint', (req, res) => {
  // 你的业务逻辑
  res.status(200).json({ message: '请求成功' });
});

// 本地测试用监听，生产环境不执行
if (process.env.NODE_ENV !== 'production') {
  app.listen(3000, () => {
    console.log('Server running on port 3000');
  });
}

// 导出Express实例供Vercel运行时调用
module.exports = app;

3. 排查细节问题 #

• 确认package.json中的依赖（如express、cors）已正确声明并安装
• 登录Vercel控制台，进入项目的Functions页面查看具体错误日志，500错误通常会包含未捕获异常、缺失依赖等详细信息

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