GitHub Actions で Next.js のビルドが遅い・メモリ不足で落ちる：キャッシュ、メモリ、ランナーの大きさ

GitHub Actions の Next.js のビルドは、遅い理由とメモリ不足で落ちる理由が別々です。遅いのは、.next/cache が次の実行に渡っていないからです。Next.js はこのキャッシュをビルドからビルドへ使い回しますが、GitHub ホストランナーのジョブは新しい VM で始まるので、キャッシュのステップがなければ毎回まっさらなビルドになります（ログに No Cache Detected と出ます）。落ちるのは、プライベートリポジトリの ubuntu-latest が 8 GB で、大きなアプリの webpack のコンパイル、型チェック、ソースマップがそれを超えるからです。1 つ目は .next/cache への actions/cache で直します。2 つ目は、まず Next.js のメモリの設定（experimental.webpackMemoryOptimizations、本番のソースマップを切る）、それでも足りなければメモリの多いマシン、16 GB か 32 GB です。

Skipbox なら、そのメモリが定額です。runs-on: skipbox-8x16 で 16 GB・8 vCPU が月 12,000 円、skipbox-16x32 で 32 GB・16 vCPU が月 23,000 円。専用のマシンなので、パッケージのキャッシュはディスクに残り、actions/cache が保存したものは手元から読みます。実行時間は無制限です。

遅い：.next/cache が空から始まる

Next.js の CI でのビルドのキャッシュのガイドによれば、Next.js は「ビルドどうしで共有するキャッシュを .next/cache に保存」し、CI がこれをビルドの間で残さないと No Cache Detected のエラーが出ます。GitHub Actions のステップはこうです。

- uses: actions/cache@v4
  with:
    path: |
      ~/.npm
      ${{ github.workspace }}/.next/cache
    key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
    restore-keys: |
      ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-

キーはソースが変わるたびに変わるので、実行のたびに新しいキャッシュを保存し、GitHub のリポジトリごと 10 GB の枠を使います。Turborepo なら、Turborepo の GitHub Actions のガイドと同じく、タスクの outputs から .next/cache を外します（"!.next/cache/**"）。

メモリ不足：2 つの別のエラー

ヒープの上限をマシンのメモリより上げると、1 つ目のエラーが 2 つ目に変わるだけです。

メモリを減らす：Next.js の設定

Next.js のメモリの使い方のガイドから。

• experimental.webpackMemoryOptimizations: true（v15.0.0 から）。コンパイルが少し長くなるかわりに、webpack のメモリのピークを下げます。
• webpack のビルドワーカー。 コンパイルを別の Node のワーカーで動かし、メモリを減らします。v14.1.0 からは、独自の webpack の設定がなければ既定で有効です。設定があるなら experimental.webpackBuildWorker: true。
• ソースマップを切る： productionBrowserSourceMaps: false と experimental.serverSourceMaps: false。「Generating static pages」で落ちるなら enablePrerenderSourceMaps: false も。
• 測る： next build --experimental-debug-memory-usage（v14.2.0 から）で、ビルド中のヒープの使用量が出て、上限が近づくとヒープのスナップショットも取れます。
• 型チェック： typescript.ignoreBuildErrors: true で型チェックとそのメモリを飛ばせますが、型のエラーがビルドに通ります。別のステップで型チェックしていないかぎり、Next.js は勧めていません。

メモリの多いマシンで動かす

月 20,000分なら、GitHub の 8 コアのランナーは 約 66,770 円参考値：2026年11月10日の為替レート・1ドル＝158.22円。米ドルの料金を、このレートで円に換算した概算です。、Skipbox M は 12,000 円。16 コアなら 約 130,060 円参考値：2026年11月10日の為替レート・1ドル＝158.22円。米ドルの料金を、このレートで円に換算した概算です。と、L の 23,000 円です。GitHub の額は、GitHub Team に含まれる無料分を引いたあとの請求です。

Skipbox が Next.js のビルドにすること

プランごとに、アカウント専用のマシンが付き、ジョブのあとも残ります。

• ビルドに足りるメモリを、ラベルで。M で 16 GB、L で 32 GB。ヒープもそれに合わせ、M なら --max-old-space-size=12288 などにします。
• パッケージのキャッシュはディスクに残ります。 ~/.npm、pnpm のストア、各ツールの ~/.cache、setup-node で入れた Node。npm ci はレジストリではなくそこから読みます。
• actions/cache の復元は、マシンから読みます。 .next/cache は追跡していないフォルダーで、チェックアウトの追跡していないファイルはジョブのたびに消すので、キャッシュのステップは残します。保存したものはマシンのそばに残り、容量は GitHub のリポジトリごと 10 GB より多く、復元は手元からの読み込みです。
• コアを足しても定額。 コンパイルと静的ページの生成がコアを使い、実行時間は無制限です。

移行は runs-on を 1行書き換えるだけ

jobs:
  build:
    runs-on: skipbox-8x16 # ubuntu-latest から書き換える
    env:
      NODE_OPTIONS: --max-old-space-size=12288
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - uses: actions/cache@v4
        with:
          path: ${{ github.workspace }}/.next/cache
          key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
          restore-keys: |
            ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
      - run: npm ci
      - run: npx next build

skipbox-8x16 はプラン M で動きます。トライアルで動くのは runs-on: skipbox です。

1. Skipbox に GitHub でログインする
2. Skipbox の GitHub アプリを入れて、使うリポジトリを選ぶ
3. runs-on を書き換えて push する

セキュリティ

• マシンはアカウントごとの専用です。ほかの会社のジョブと同じマシンで動くことはありません。
• ジョブが終わるたびに、ランナーの認証情報、プロセスとコンテナを消し、残したチェックアウトからも git の認証情報と追跡していないファイルを消します。「毎回クリーン」なら、ジョブごとに新しいマシンで動きます。
• 書き込み権限のない人のコード（フォークからのプルリクエストなど）は、使い捨ての VM で動きます。キャッシュは読めますが、書き換えられません。

くわしくはジョブの分離のしくみにあります。

Next.js のビルドで試す

カード不要で、7日間かジョブの合計 3,000分まで無料です。トライアルは runs-on: skipbox、メモリ 16 GB で、プライベートリポジトリの ubuntu-latest の 2倍です。キャッシュもメモリもそこで試し、さらにメモリが要るビルドはプラン L（skipbox-16x32、32 GB）に移してください。

2026年11月13日 更新