GitHub pushできない時の確認

pushできない時は、認証、権限、branch、remote、pull不足、conflict、大きなファイルなどを順に分けて確認します。焦って値を貼り直したり、履歴を書き換える操作へ飛ばないことが大切です。

このページでわかること

  • 認証・権限・branch・remoteを分けて見る
  • pullが必要な状態やconflictを確認する
  • Secretsや大きなファイルが混ざっていないか見る

まず確認すること

  • エラーメッセージの対象repoとbranchを見る
  • 権限がないrepoへ送ろうとしていないか見る
  • push前のcommitに不要ファイルが入っていないか見る

やってはいけないこと

  • エラー文に認証情報を貼って共有する
  • 原因不明のまま強い操作へ進む
  • push失敗を無視して公開済みと思い込む

安全寄りに進める手順

  1. 対象のrepo、branch、PR、Actions runを確認する。
  2. Secrets、APIキー、token、.env、個人情報が差分やログに出ていないか見る。
  3. 必要な場合は値を停止または再発行し、影響範囲を整理する。
  4. 変更は小さなbranchとPRに分け、CIとreviewで確認する。

CodexやAI作業時の注意

AIに作業を渡す時は、対象ファイル、触らないファイル、確認項目を明記します。認証情報や実際のキー値は本文、Issue、PR説明、ログ、レポートに残さないようにします。

公式情報で確認する領域

Actions、Secrets、PR、repository visibility、workflow permissionsは仕様が変わることがあります。実作業前にはGitHub Docsで最新の説明を確認してください。

pushが拒否される代表的な形と、gitのメッセージ

  • rejected(non-fast-forward): ! [rejected] main -> main (non-fast-forward) に続けて failed to push some refs と出ます。GitHubの公式ドキュメントによると、原因は同じbranchに他の人が先にpushしていることで、そのまま上書きすると相手のcommitを失うため、gitが止めています。gitの公式文書は、branchへのpushはfast-forward(送る側のcommitが、リモートの現在のcommitの子孫になること)の更新だけを許すとしています。
  • 直し方: GitHubは、git fetch origin で取り込んでからmergeするか、git pull で両方を一度に行うよう案内しています。gitの公式文書には、git pull で衝突を直してpushする方法と、git pull --rebase してpushする方法が書かれています。どちらも、リモートの変更を手元に取り込んで再度pushする流れです。
  • remote rejected: 手元ではなく、受け取る側が拒否した状態です。gitの公式文書は、hookや、receive.denyNonFastForwards などのサーバー側設定が原因になりうるとしています。
  • remote failure: リモートが更新を確認できなかった状態で、一時的なエラーや接続の切断が考えられるとされています。
  • 認証: GitHubのremote URLは、HTTPS(https://github.com/user/repo.git)とSSH(git@github.com:user/repo.git)の2種類です。HTTPSのパスワード欄に入れるのは、パスワードではなくpersonal access tokenです。公式は、パスワードでのgit認証は、より安全な方法に置き換えられたと書いています。SSHでは、SSH keyを作ってアカウントに登録します。
  • 初回のpushで追跡先がない時は、git push --set-upstream origin main(-u)で設定できます。

出典: git-push、Dealing with non-fast-forward errors、About remote repositories/確認日 2026年11月2日

force系オプションを、AIに任せて良いか

gitの公式文書は、--force は通常の安全確認をすべて無効にし、リモートがcommitを失うことがあるので注意して使うと書いています。公式が例に挙げる使いどころは、すでにpushしたcommitを自分で作り直した場合など、履歴を失うことを意図している場合に限られます。

--force-with-lease は、リモートの現在の値が期待どおりの場合にだけ上書きし、そうでなければ失敗します。ただし公式は、バックグラウンドで git fetch が走る環境では、期待値を省いた形が安全に働かなくなると警告しています。

「pushできないから強制する」はAIがやりがちな回避策ですが、まず上のメッセージの種類を読み分け、non-fast-forwardなら取り込みを先に行う、という順番を指示に書いておくと安全です。

出典: git-push/確認日 2026年11月2日

関連ページ