部署Node.js服务器至Vercel遇错误，求故障原因排查

开发者阿泽

2026-7-31

Node服务器部署Vercel报错原因分析

错误截图

项目结构

项目结构截图

当前vercel.json配置

{
  "version": 2,
  "builds": [
    {
      "src": "./server.js",
      "use": "@vercel/node"
    }
  ],
  "routes": [
    {
      "src": "/(.*)",
      "dest": "/"
    }
  ]
}

可能的错误原因

路由配置错误：routes中的dest设置为"/"，但Vercel需要将请求转发到指定的Node入口文件（即server.js），正确的dest应该是"/server.js"。当前配置会把所有请求指向根路径，而根路径没有对应的处理逻辑，导致部署后请求无法被正确处理。
入口文件路径匹配问题：如果server.js的实际路径与builds中src配置的./server.js不符（比如在子目录中），会导致Vercel找不到入口文件，但从项目结构截图看，server.js应该在根目录，此可能性较低。
Vercel Node运行时映射逻辑问题：当前路由规则未正确关联到@vercel/node运行时处理的入口文件，需要确保路由的dest指向builds中配置的src文件，才能让请求被Node服务器处理。