部署Node/Express+Create React App项目到Vercel出现警告和404问题求助

架构老林

2026-10-4

Vercel部署问题原因与解决方案

问题1：构建日志builds配置警告

产生原因

你参考的教程使用了Vercel已废弃的builds配置项，当前Vercel统一使用functions配置处理服务端路由逻辑，配置文件中存在的builds字段会强制覆盖Vercel项目后台的默认构建与开发设置，因此触发该警告。

问题2：部署后访问返回404

产生原因

主要由配置失效导致：一是废弃的builds配置无法正确识别Express后端的入口文件，服务端路由没有被Vercel云函数正常代理；二是重定向规则配置错误，没有把前端静态资源请求、后端接口请求转发到对应的目标路径，导致请求匹配不到资源返回404。

具体解决步骤

调整项目根目录下的vercel.json配置，删除所有builds相关配置，替换为适配当前Vercel规则的配置内容，参考示例如下（可根据你的实际项目结构调整路径）：

{
  "version": 2,
  "buildCommand": "cd client && npm install && npm run build",
  "outputDirectory": "client/build",
  "functions": {
    "api/**/*.js": {
      "runtime": "@vercel/node@3"
    }
  },
  "rewrites": [
    {
      "source": "/api/(.*)",
      "destination": "/api/$1"
    },
    {
      "source": "/(.*)",
      "destination": "/"
    }
  ]
}

如果你的Express入口文件存放在根目录的index.js而非api文件夹下，可将rewrites第一条规则的目标路径修改为你的入口文件路径，比如/index.js。