コンテンツへスキップ

GitHub Actionsの終了コード137: メモリ不足の修正方法

最終更新: · 初回公開:

Process completed with exit code 137は、ジョブ内のプロセスがSIGKILLで強制終了されたことを意味し、GitHub Actionsでは通常、ランナーのメモリ不足が原因です。終了コードの137は128に9を加えた値で、9はSIGKILLシグナルを指します。以下では、メモリ不足であることの確認方法、ランナーのRAM容量、Node、Jest、Gradle、Dockerでの対処法を説明します。

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

Error: Process completed with exit code 137.

シェルステップでこのエラーが表示されるのは、そのコマンドまたは起動したプロセスがSIGKILLで終了した場合です。Dockerの出力ではKilledやOOMKilled: trueが表示されることもあります。137の原因はほかにもあります(kill -9、コンテナの停止タイムアウト、ジョブのキャンセルなど)が、CIではメモリ不足が圧倒的に多い原因です。

ランナーのメモリ容量はどれくらいですか?

GitHubのランナーのリファレンスによると(2026年10月時点で確認):

リポジトリ標準のLinuxランナーRAM
パブリック4 CPU16 GB
プライベート2 CPU8 GB

16GBや32GBのノートPCでは成功するビルドでも、8GBのプライベートリポジトリ用ランナーでは失敗することがあります。特に、ツールが検出したCPUコアごとにワーカーを起動する場合に起こりやすくなります。

メモリ不足であることを確認する

- name: Memory check after failure
  if: failure()
  run: |
    free -m
    sudo dmesg | grep -i -E "killed process|out of memory" | tail

dmesgにOut of memory: Killed processと表示されていれば、原因は確定です。また、ビルド中に数秒ごとにメモリ使用量を記録することもおすすめします:

- run: |
    (while true; do date +%T; free -m | sed -n 2p; sleep 5; done) &

原因と対処法

1. Node.jsのビルドとバンドラー

Nodeのデフォルトのヒープ上限はバージョンやシステムメモリによって異なり、大きなバンドルではこの上限に達することがあります。上限を引き上げる場合も、ランナーのRAM内に収まるように設定してください:

- run: npm run build
  env:
    NODE_OPTIONS: --max-old-space-size=6144

CIではソースマップを無効にする、型チェックとビルドを別のステップに分けるといった方法でも、メモリ使用量を抑えられます。

2. ワーカー数が多すぎるJest、Vitest、その他のテストランナー

各ワーカーは独自のテスト環境を保持する完全なプロセスであり、リークするテストがあるとメモリが増え続けます。

- run: npx jest --maxWorkers=2 --logHeapUsage
- run: npx jest --runInBand   # slowest, lowest memory

--detectOpenHandlesと--logHeapUsageでリークを見つけられます。Jest 29以降は--workerIdleMemoryLimit=1GBもサポートしており、サイズが大きくなったワーカーを再起動します。テストのシャーディングを使うと、テストを複数のジョブに分散でき、メモリ使用量も分散されます。

3. GradleとMaven

Gradleデーモン、Kotlinコンパイルデーモン、テスト用のJVMはそれぞれ独自のヒープを使用し、合計すると8GBを超えることがあります。

- run: ./gradlew build --no-daemon
  env:
    GRADLE_OPTS: -Xmx2g

gradle.propertiesの設定例:

org.gradle.jvmargs=-Xmx2g -XX:MaxMetaspaceSize=512m
org.gradle.workers.max=2
kotlin.daemon.jvm.options=-Xmx1g

Mavenの場合はMAVEN_OPTS: -Xmx2gを設定し、スレッド数を増やす代わりに-T 1を使用してください。テストがJVMをフォークする場合は、SurefireでforkCountを設定し、argLineに-Xmxを指定します。

4. Dockerビルドとサービスコンテナ

コンテナがメモリ上限に達したか、ホスト全体のメモリが不足しています。docker build内のコンパイル工程(並列度の高いRustやC++のビルドなど)が典型例です。並列数を下げ(cargo build -j2、make -j2)、メモリを多く使うサービスには明示的な上限を設定してください:

services:
  es:
    image: elasticsearch:8.15.0
    env:
      ES_JAVA_OPTS: -Xms512m -Xmx512m

5. 自分のコードやテストのメモリリーク

テストファイルごとにメモリが増加する場合は、コードに原因があります。リークを修正するか、ワーカーをより頻繁に再起動してください。

6. キャンセルされたジョブやタイムアウトしたジョブ

実行をキャンセルした場合や、ステップが[timeout-minutes](/errors/timeout-minutes)に達した場合も、プロセスは強制終了されます。まず同時実行によるキャンセルを除外してください(The operation was canceledを参照)。

チューニングだけでは不十分な場合

RAMの多いマシンを使用してください。選択肢は、GitHubの大規模ランナー(大規模ランナーのドキュメントを参照)またはランナープロバイダーです。compiler.devのデフォルトのLinuxマシンは8 vCPU / 16 GBで、ジョブごとに新しいVMが起動します。料金は2026年10月時点で1分あたり$0.008です。runs-on: [self-hosted, Linux, compiler-ci]を指定して切り替えられます。詳しくは料金とランナーサイズの選択ツールをご覧ください。ジョブでディスク容量も不足する場合は、No space left on deviceを参照してください。ランナー自体がクラッシュした場合の表示は異なり、lost communicationを参照してください。

予防方法

  1. CIでピークメモリ使用量を記録し、ランナーのRAM容量より低い値でアラートのしきい値を設定してください。
  2. 自動検出に頼らず、すべてのツールに明示的なヒープとワーカーの上限を指定してください。
  3. リンター、型チェック、ビルド、テストは、それぞれ別のジョブとして実行してください。
  4. 小さなランナーでは、重い処理を一度に1つだけ実行してください。
  5. バンドルサイズやテストのメモリ使用量を増やす依存関係のアップグレードは、慎重に確認してください。

よくある質問

終了コード137は何を意味しますか

プロセスがSIGKILLを受け取ったことを示します。137は128 + 9に相当します。CIでは、ほぼ常にカーネルのOut-of-Memory killerによるものです。

終了コード137と143は同じですか

いいえ。143はSIGTERM(128 + 15)で、キャンセル時によく送られる、穏やかな停止要求です。137は強制終了です。

ローカルでは動くのはなぜですか

ローカルマシンはメモリ容量が多く、CPUコア数も異なります。ランナーのメモリは固定で、容量も小さめです。

スワップを追加すると効果がありますか

強制終了を遅らせられる場合もありますが、ビルドの速度が大きく低下します。メモリ使用量を減らすか、より大きなマシンを使用することをお勧めします。