GitHub pushできない時の確認
pushできない時は、認証、権限、branch、remote、pull不足、conflict、大きなファイルなどを順に分けて確認します。焦って値を貼り直したり、履歴を書き換える操作へ飛ばないことが大切です。
このページでわかること
- 認証・権限・branch・remoteを分けて見る
- pullが必要な状態やconflictを確認する
- Secretsや大きなファイルが混ざっていないか見る
まず確認すること
- エラーメッセージの対象repoとbranchを見る
- 権限がないrepoへ送ろうとしていないか見る
- push前のcommitに不要ファイルが入っていないか見る
やってはいけないこと
- エラー文に認証情報を貼って共有する
- 原因不明のまま強い操作へ進む
- push失敗を無視して公開済みと思い込む
安全寄りに進める手順
- 対象のrepo、branch、PR、Actions runを確認する。
- Secrets、APIキー、token、.env、個人情報が差分やログに出ていないか見る。
- 必要な場合は値を停止または再発行し、影響範囲を整理する。
- 変更は小さな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日