コンテンツへスキップ

GitHub Actionsで「The operation was canceled」が出る原因

最終更新

The operation was canceledは、GitHubがジョブやステップを完了前に意図的に停止したことを意味します。新しい実行による置き換え、並列ジョブの失敗、タイムアウト、または誰かによるキャンセル操作が原因です。多くの場合、コードの誤りではありません。このページでは、起こりやすい原因の順に説明し、実行ページでの見分け方を示します。動作内容はGitHubのワークフロー構文リファレンスに基づいており、2026年10月時点で確認しています。

表示される正確なメッセージ

Error: The operation was canceled.

これと併せて表示される可能性のあるメッセージ:

Canceling since a higher priority waiting request for 'ci-refs/heads/main' exists
Error: The run was canceled by @username.
The runner has received a shutdown signal.

実行の概要ページ上部にあるアノテーションを確認してください。原因はたいてい、そこに記載されています。

原因1: cancel-in-progressを指定したconcurrency

ワークフローでconcurrencyをcancel-in-progress: trueとともに宣言していると、同じグループで再度プッシュしたときに、先行する実行がキャンセルされます。キャンセルされたジョブにはThe operation was canceledと記録されます。

concurrency:
  group: ci-${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

これはプルリクエストのCIでは望ましい動作です。一方、デプロイやリリースのジョブでは、途中でキャンセルすると処理が中途半端なまま残るおそれがあるため、望ましくありません。また、GitHubの仕様として、cancel-in-progressを指定していなくても、同じグループ内で保留中のpendingの実行は、新たにキューに入った実行に置き換えられます。「higher priority waiting request」というメッセージは、この動作を示しています。

デプロイでの対処法:

concurrency:
  group: deploy-production
  cancel-in-progress: false

falseにすると、1つの実行は進み、もう1つは待機します。ただし、古い待機中の実行は引き続き破棄されます。すべての実行を必ず完了させる必要がある場合は、実行ごとに一意のグループ名を使うか、マージキューを利用してください(GitHubのマージキューを参照)。キャンセルはCIジョブでのみ行うようにします:

concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: ${{ github.event_name == 'pull_request' }}

原因2: matrixのfail-fast

matrixではfail-fastの既定値がtrueです。いずれかのセルが失敗すると、GitHubは実行中の他のセルをキャンセルします。その結果、正常に動いていたセルでも「The operation was canceled」と報告されます。本当の失敗は、赤く表示された1つのセルにあり、キャンセルされたセルにはありません。

strategy:
  fail-fast: false
  matrix:
    node: [18, 20, 22]

デバッグ中はfail-fast: falseを設定し、各セルの実際の結果を確認してください。詳しくはmatrixビルドを参照してください。

原因3: タイムアウト

ステップまたはジョブがtimeout-minutesを超えると、キャンセルされます。ステップの上限は360分で、GitHub がホストするジョブは6時間が上限です。多くの場合、入力や外部ネットワークサービスの応答を待ったまま止まっています。timeout-minutesの動作と実行時間の制限を確認してください。明示的な制限を設定すると、ハングアップしたときに早く失敗させられます:

jobs:
  test:
    timeout-minutes: 20
    steps:
      - run: npm test
        timeout-minutes: 15

原因4: 人間またはAPIによる実行の停止

誰かが「Cancel workflow」をクリックしたか、自動化の仕組みがAPIを呼び出した可能性があります。次のコマンドで確認できます:

gh run view RUN_ID --log | head -50
gh api repos/OWNER/REPO/actions/runs/RUN_ID --jq '.conclusion, .actor.login'

リリース用のツールや、他のワークフロー内のgh run cancelなどのボットによる停止もよくあります。

原因5: ランナーのシャットダウンや喪失

スポットインスタンス上のセルフホストランナー、またはリブートするランナーホストでは、The runner has received a shutdown signalが表示され、その後ステップがキャンセルされます。GitHubがホストするランナーも、インフラの問題が起きた後に回収されることがあります。グレースフルなドレインを備えた一時的なランナー(ephemeral runner)を使うか、GitHubがホストするランナーに切り替えてください。ログに代わりに通信が失われたと記載されている場合は、ホストランナーとの通信喪失を参照してください。

原因6: 依存先のジョブが失敗した

needs:を持つジョブは、依存するジョブが失敗したときにキャンセルではなくスキップされます。キャンセルが発生している場合は、まずfail-fastまたは同時実行(concurrency)の設定を確認してください。if: always()のクリーンアップステップがキャンセル時にも実行されるのは、if: always()またはif: cancelled()を使用している場合のみです:

- name: Clean up
  if: always()
  run: ./cleanup.sh

手順に沿った原因の切り分け

  1. 実行の概要ページを開き、アノテーションを確認します。誰が、または何がキャンセルしたかが書かれていることが多くあります。
  2. ワークフローにconcurrency:があるか確認します。あり、かつcancel-in-progress: trueであれば、それが原因である可能性が高いです。
  3. matrixを使っているか確認します。いずれかのセルが失敗していれば、そのセルを修正してください。
  4. ジョブの実行時間をtimeout-minutesと比較します。
  5. セルフホストランナーでのみ発生する場合は、ホストのログでリブートの有無を確認します。

予防方法

  1. concurrencyのグループはブランチごとに分け、すべてのブランチで1つのグループを共有しないようにします。
  2. デプロイ用やリリース用のワークフローではcancel-in-progressを無効にします。
  3. 各セルが独立しているmatrixではfail-fast: falseを設定します。
  4. すべてのジョブと時間のかかるステップにtimeout-minutesを追加します。
  5. 必ず実行すべき後片付けにはif: always()を使います。

キャンセルされた実行も、停止するまでの時間分の分数が課金されます。そのためconcurrencyの設定は費用の削減にもつながります(GitHub Actionsの料金を抑える方法を参照)。キューの待ち時間を減らす効果もあります(ランナーの待機を参照)。ジョブを短くしてキャンセルされる頻度を下げたい場合は、compiler.devをご利用ください。既存のジョブを、runs-onの1行の変更だけで、8 vCPU / 16 GBのマシン上で実行できます。

よくある質問

cancel-in-progressは古い実行だけをキャンセルしますか?

はい。concurrencyグループ内で最新の実行は継続されます。cancel-in-progress: trueの場合は、同じグループで進行中の古い実行がキャンセルされます。

成功していたはずのmatrixのセルがcanceledと表示されるのはなぜですか?

fail-fastの既定値はtrueです。失敗したセルがあると、まだ実行中の他のセルがキャンセルされます。

実行を誰がキャンセルしたかを確認できますか?

はい。実行の概要のアノテーションに表示され、API のフィールドactorと、リポジトリの監査ログで確認できます。

キャンセルされた実行は課金されますか。

キャンセルされるまでに使用した分のみ、料金をお支払いいただきます。