Vercel部署后端服务后出现404错误求助

1. 检查Vercel配置文件正确性 #

Vercel运行后端服务需要配置文件识别入口，确保项目根目录有vercel.json（或now.json），并配置对应路由与运行时：

• 以Node.js项目为例，配置示例：

  {
    "functions": {
      "api/**/*.js": {
        "runtime": "@vercel/node@2.x"
      }
    },
    "routes": [
      { "src": "/(.*)", "dest": "/api/index.js" }
    ]
  }
  

  需根据你的实际入口文件（如server.js）调整dest路径。

2. 核对后端路由匹配规则 #

• 访问路径必须和后端定义的路由完全匹配，比如后端仅注册了/api/users接口，直接访问根路径/会触发404。
• 检查后端代码路由配置，比如Express项目：

  app.get('/api/hello', (req, res) => {
    res.send('Hello World!');
  });
  

  此时需访问https://你的Vercel域名/api/hello，而非根路径。

3. 查看Vercel部署日志 #

登录Vercel控制台，进入项目的Deployments页面，点击对应部署记录查看Logs标签：

• 日志若出现依赖缺失、代码语法错误（如Module not found），会导致服务启动失败，进而引发404。需先修复代码或依赖问题，再重新部署。

4. 确认部署的分支与代码版本 #

• vercel --prod默认部署当前分支代码，检查当前分支是否为目标分支，有无未提交的修改。
• 可在Vercel控制台手动选择指定分支部署，确保代码为最新且正确版本。

5. 检查Vercel服务类型设置 #

进入项目Settings -> General -> Framework Preset，确保选择对应后端框架（如Node.js），而非静态站点（Static）。若选静态站点，Vercel仅部署静态文件，不会运行后端服务，导致404。

6. 本地测试服务可用性 #

先在本地执行启动命令（如npm run start），用浏览器或Postman访问本地接口，确认服务能正常响应。若本地也报错，优先修复本地问题后再重新部署。

内容的提问来源于stack exchange，提问作者Muhammad Mahfuzur Rahman