GitHub Actionsが動かない時のチェックリスト
Actionsが動かない時は、workflowの場所、yaml、trigger、branch、permissions、Secrets、ログ、Pages build、schedule、直前差分を順番に確認します。
このページでわかること
- workflowが実行されない原因を分けて見る
- trigger、branch、permissions、Secretsを確認する
- CIを止める前にログと差分を見る
まず確認すること
- workflowファイルの場所と構文を確認する
- Actions設定と実行ログを見る
- third-party actionや直前変更を確認する
やってはいけないこと
- CIを消して終わりにする
- 失敗ログを無視する
- 権限を広げて解決扱いにする
安全寄りに進める手順
- 対象の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で最新の説明を確認してください。
workflowが起動しない時に、公式が挙げている条件
GITHUB_TOKENが起こしたイベントでは、新しいworkflowの実行は作られません。例外はworkflow_dispatchとrepository_dispatchです。branchesとpathsの両方を書いた時は、両方の条件を満たした時だけ動きます。tagsだけ、またはbranchesだけを書いた場合、書いていない種類のgit参照への変更では動きません。- pathの絞り込みを使っていて、変更されたファイルがなければ動きません。差分が3,000ファイルを超え、該当ファイルが最初の3,000件に入らない場合も動きません。タグのpushではpathの絞り込みは評価されません。
workflow_dispatch(手動実行)は、workflowファイルがデフォルトbranchにある時だけイベントを受け取ります。pull_requestは、既定では opened、synchronize、reopened の時だけ動きます。PRに merge conflict があると動かないので、先に衝突を直す必要があります。- フォークしたリポジトリでは、既定でworkflowは動きません。フォーク側のActionsタブで有効にします。フォークから起動された場合、
GITHUB_TOKEN以外のSecretsはrunnerに渡されません。 scheduleは、デフォルトbranchの最新commitで動き、最短間隔は5分です。高負荷の時は遅れたり、待ちのjobが落とされたりします。公開リポジトリでは、60日間リポジトリの活動がないと自動で無効になります。- branchやpathの絞り込みでスキップされたworkflowは、チェックが「Pending」のまま残り、そのチェックを必須にしているPRはmergeできなくなることがあります。
出典: Triggering a workflow、Events that trigger workflows/確認日 2026年11月2日
ログの開き方と再実行の方法
- リポジトリの「Actions」タブを開き、左のサイドバーでworkflowを選びます。
- 実行の一覧から対象の実行を開き、「Jobs」から失敗したjobを選びます。失敗したstepは自動で展開されます。
- ログの右上の「Search logs」で検索できますが、検索の対象は展開されているstepだけです。歯車のメニューの「Download log archive」で、ログをまとめて保存できます。一部のjobだけを再実行した場合、アーカイブには再実行したjobのログしか入りません。
GitHub CLIなら、gh run view 実行ID --log でログを表示でき、gh run view --job ジョブID --log-failed で失敗したstepだけを表示できます。
再実行は、実行の概要画面の「Re-run jobs」から、すべてのjob、失敗したjobだけ、または1つのjobを選べます。CLIでは gh run rerun 実行ID、失敗分だけなら --failed です。公式によると、再実行できるのは最初の実行から30日以内で、1つの実行につき最大50回までです。再実行は元と同じ GITHUB_SHA と GITHUB_REF を使い、権限は最初に起動した人のものが使われます。詳しいログが必要な時は、「Enable debug logging」を選んでから再実行します(CLIでは --debug)。なお、workflowが無効になっている間は再実行できません。
出典: Using workflow run logs、Re-running workflows and jobs/確認日 2026年11月2日