为何Vercel部署React应用时提示缺失routes-manifest.json？

问题描述 #

我尝试通过Vercel CLI部署React应用，操作步骤如下：

• 安装Vercel CLI并运行vercel命令初始化部署
• Vercel自动检测React应用并配置部署参数
• 执行vercel --prod触发生产部署

但部署时终端抛出错误：

Error: The file "/vercel/path0/Next.js/routes-manifest.json" couldn't be found. This is often caused by a misconfiguration in your project.

本地项目的.next目录中确实存在routes-manifest.json文件，已尝试过重启设备、清除缓存、卸载重装Vercel CLI，问题仍未解决。

可能的解决办法 #

1. 强制指定React项目构建配置
   Vercel可能错误将React项目判定为Next.js项目，导致部署流程出错。在项目根目录创建vercel.json文件，手动指定React构建规则：

{
  "buildCommand": "npm run build",
  "outputDirectory": "build",
  "framework": "create-react-app"
}

保存后重新执行vercel --prod。

2. 清理Vercel远程缓存
   本地缓存清理无效时，可清除Vercel远程缓存后重新部署：

vercel build --clean
vercel --prod

3. 确认项目根目录结构
   确保package.json在项目根目录（Vercel依赖该文件识别项目类型）。若React项目嵌套在子目录，部署时指定工作目录：

vercel --prod --cwd ./你的React子目录路径

4. 重新关联Vercel项目
   解除本地项目与Vercel的关联后重新初始化：

vercel link --remove
vercel link
vercel --prod

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