Vercel が git push してもデプロイされない
Vercel が git push でデプロイされないなら、Project Settings → Git の連携と Production Branch を直す。
Skipped と出るなら Ignored Build Step を見直す。
公開: 更新:
要約
git push で Vercel デプロイが走らないのは、多くの場合 Git 連携の問題か Ignored Build Step の skip が原因である。
Project Settings → Git で連携と Production Branch を、Deployments タブで Skipped 表示を確認すれば、どの段階で止まっているかが分かる。
解決策
1. 連携と branch 設定を確認
Project → Settings → Git で以下を確認する(公式 Git Deployments(新しいタブで開く) 参照)。
- Connected Repository が正しい
- Production Branch が push 先のブランチ名と一致
Connected branchesに Preview したいブランチが含まれる
2. Deployments タブで状態を見る
Deployments タブで Skipped が表示されていれば、Ignored Build Step による skip である。
ジョブ自体が現れないなら、webhook が届いていない。
後者は Vercel App の再連携で直ることが多い。
3. Ignored Build Step を見直す
# Ignored Build Step の例(変更があれば exit 1 でビルド継続)
git diff HEAD^ HEAD --quiet ./ && exit 0 || exit 1exit 0 を返すとビルドを skip し、exit 1 を返すと続行する。
意図と逆になっていないか確認する。
4. monorepo の Root Directory を確認
monorepo の場合、対応 Project の Root Directory 配下に変更が無いとビルドされない。
Turborepo の affected 検出と組み合わせるとさらに堅い。
npx turbo-ignore @your/app5. GitHub 側の App 権限を再確認
GitHub → Settings → Integrations → Vercel App → Configure → Repository access を開き、All repositories か、Selected repositories で対象リポジトリにチェックが入っているかを確認する。
詳細は公式の Vercel for GitHub(新しいタブで開く)に書かれている。
よくある原因
- Git 連携が切れている。
GitHub Org の設定で、Vercel App のリポジトリアクセスが外れている。 - Production Branch が一致していない。
mainに push したのに、Settings はmasterのままになっている。 - Ignored Build Step で skip されている。
git diffでビルド不要と判定してexit 0を返し、サイレントに skip している。 - 変更が monorepo の Root Directory の外にある。
apps/fooの Project に対して、apps/barだけを変更した push をしている。 - Vercel App の権限が漏れている。
GitHub 側でSelected repositoriesを使っていて、対象のリポジトリが含まれていない。