Vercel单仓库多项目间歇性部署失败求助

1. 排查Vercel部署队列与平台状态 #

• Pro套餐4并发构建上限下，47个项目同时触发部署可能导致队列异常。直接在Vercel控制台手动触发那些无记录的项目部署，验证是否能正常执行。
• 确认Vercel官方状态是否存在平台级故障，临时波动可能导致部分部署任务丢失。

2. 验证Ignored Build Step配置 #

• 检查Only build production的具体执行命令（比如if [ "$VERCEL_ENV" != "production" ]; then exit 0; else exit 1; fi）是否在所有47个项目中一致生效。部分项目可能因分支命名、环境变量异常，导致构建被意外跳过，但Git端误报失败。
• 临时移除Ignored Build Step配置，提交一次小变更测试，看所有项目是否能生成部署记录，排除配置冲突。

3. 检查Git与Vercel的Webhook同步 #

• 查看仓库的Webhook设置，确认Vercel的Webhook是否存在失败请求记录。若Webhook未触发或触发失败，会导致Vercel未收到构建指令，但Git显示检查未通过。
• 手动重新推送Webhook，或在Vercel中手动导入最新提交，强制触发全量部署。

4. 排查项目构建的隐性问题 #

• 即使是小CSS修复，部分项目可能存在缓存异常，导致构建资源占用过高被终止且无日志。本地使用vercel build命令模拟Vercel构建环境，逐个测试“失败”项目，排查隐性错误。
• 优化Vite构建配置（如开启build.cache减少资源消耗），或向Vercel申请Pro套餐的更高资源配额。

5. 联系Vercel官方支持 #

• 若以上方法无效，提交Vercel支持工单，提供以下关键信息：
  • 仓库ID及47个项目的列表
  • 异常部署的提交哈希值
  • Git状态异常截图：
  • 之前成功部署的时间与提交记录对比

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