Vercel CI/CD未触发问题：Git提交推送后无法自动构建

• 检查项目自动部署开关与分支规则
  进入项目Settings → Git页面，确认Automatic Deployments处于开启状态，同时检查分支过滤列表，确保你推送的分支在允许触发部署的范围内。另外注意是否勾选了跳过含[skip ci]类关键词的提交，若你的提交信息包含这类内容，会被自动忽略。

• 验证Git仓库的Webhook状态
  登录你的Git平台（GitHub/GitLab等），进入对应仓库的Settings → Webhooks页面：

  • 确认Vercel添加的Webhook存在且状态为Active
  • 查看Webhook的Recent Deliveries记录：
    • 无记录：说明Git平台未向Vercel推送事件，检查Vercel的OAuth应用权限，确保其拥有仓库的Webhook读写权限，必要时重新授权
    • 有错误记录：根据错误码排查，比如401代表权限失效，404代表Webhook地址无效，可删除旧Webhook后重新关联Vercel项目

• 排查部署忽略规则
  查看项目根目录的vercel.json文件，检查是否配置了ignoreCommand或build.ignore规则，例如：

  {
    "ignoreCommand": "git diff HEAD~1 --quiet"
  }
  

  这类规则会让Vercel判断代码无变更而跳过构建，按需删除或修改该规则。

• 修正分支关联与手动触发基准部署
  重新关联仓库时，明确选择当前最新的目标分支；若仍有问题，在Vercel项目的Deployments页面，点击Deploy → Deploy Specific Commit，输入最新提交的Hash完成部署，之后再推送新提交测试自动触发机制。

• 检查账户与团队权限
  若为团队项目，确认你的账户拥有项目的Deploy权限，同时检查团队的Git集成配置，确保没有限制自动部署的规则。另外可查看Vercel后台的系统状态，确认无平台级故障导致Webhook异常。

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