Vercel部署报错vercel build exited with 1无public输出目录如何解决

核心报错对应 #

部署时抛出的两个错误是关联关系：vercel build exited with 1是构建流程非0退出的总提示，No Output Directory named "public" found是退出前检测产物阶段抛出的直接错误，按以下顺序排查即可：

• 第一步：先确认本地真实构建产物路径
  先在本地项目根目录执行你配置的生产构建命令（比如npm run build），等构建跑完看根目录下实际生成的产物文件夹名称：
  • Vite/Vue3项目默认产物目录是dist
  • Create React App项目默认产物目录是build
  • Next.js静态导出默认产物目录是out
  • 只有Hugo等少数静态站点生成器默认产物是public

  高频踩坑：大部分前端框架里的public文件夹是源码目录，用来存放构建时原封不动拷贝的静态资源，不是最终部署用的构建产物目录，别把源码目录和产物目录搞混。

• 第二步：修正Vercel的输出目录配置
  Vercel自动识别框架失败时，会默认把public当成输出目录，手动改成你实际的产物目录即可，两种配置方式二选一：
  1. 控制台配置：进入对应项目的 Settings > General 页面，找到Build & Development Settings板块，修改Output Directory为你本地实际生成的产物文件夹名，保存后重新触发部署。
  2. 配置文件配置：在项目根目录新建vercel.json文件，写入对应配置，例：

  {
    "buildCommand": "npm run build",
    "outputDirectory": "dist"
  }
  

  把outputDirectory的值替换成你自己的产物目录名即可，配置提交后会自动触发部署。
• 第三步：排查构建流程本身的执行异常
  如果改完输出目录还是报错，说明构建阶段就已经失败，根本没生成任何产物，才会触发目录找不到的提示：
  • 翻Vercel部署日志里这两个错误之前的输出，排查有没有依赖安装失败、代码语法报错、环境变量缺失的问题，最常见的是没把包管理锁文件（package-lock.json/yarn.lock/pnpm-lock.yaml）提交到仓库，导致Vercel安装的依赖版本和本地不一致，构建中途崩溃。
  • 检查构建命令配置是否和本地一致，比如部分项目自定义的生产构建命令是npm run build:prod，Vercel默认跑npm run build会执行空操作，自然不会生成产物。
• 第四步：特殊场景校验
  • 如果你用Monorepo架构，检查Vercel项目配置里的Root Directory是否指向了正确的应用子目录，路径不对会导致构建在仓库根目录执行，找不到子项目生成的产物。
  • 检查项目根目录的.gitignore、.vercelignore文件，确认没有把构建产物目录加入忽略列表，否则Vercel构建完成后会跳过对应目录的读取，判定为目录不存在。
  • 如果你确实需要用public作为输出目录，确认本地构建执行完成后，项目根目录真的会生成打包后的public文件夹，不要把源码阶段存放静态资源的public目录误当成构建产物。

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