Vercelのビルドキャッシュ上限が全ビルドマシンで5GBに — 何が変わり、どこを確認すべきか

Vercel は 2026年11月13日、すべてのビルドマシンでビルドキャッシュの上限を 5 GB に引き上げました。設定変更は不要で、追加料金もかかりません。これまでは上限を超えたキャッシュが丸ごと破棄され、次のビルドがキャッシュなしで始まっていたため、依存関係が大きいプロジェクトほど恩恵があります。ただし「キャッシュは大きいほど良い」わけではありません。キャッシュのアップロードはビルド時間として課金されるため、確認すべきポイントがあります。
変更点: 旧上限はマシン種別ごとにバラバラだった
変更前の上限は、Basic と Standard が 1.5 GB、Enhanced が 3 GB、Turbo が 4.75 GB でした。今回これが一律 5 GB になり、ビルドごとにマシンが自動割り当てされる Elastic を含むすべてのマシン種別に適用されます。キャッシュの保持期間は従来どおり 1 か月で、ビルドキャッシュキー単位で管理されます。
重要なのは、旧来の挙動では上限を超えたキャッシュが「切り詰められる」のではなく「保存されない」点です。つまり 1.51 GB のキャッシュを作った Standard のプロジェクトは、キャッシュ作成に時間を使ったうえで、次のビルドを完全にコールドスタートしていました。上限が 1.5 GB から 5 GB になったことで、この「作っては捨てる」ループから抜けられるプロジェクトが出てきます。
そもそも何がキャッシュされているのか
Vercel のドキュメントによると、ビルド成功時にキャッシュへ保存されるのは主に次のものです。
- ビルダーの出力。
@vercel/nodeはリポジトリ内のすべてのnode_modulesと.yarn/cacheをキャッシュします - プロジェクト設定で選択したフレームワークプリセットに対応するフレームワークファイル(Next.js なら
.next/cacheなど) .vercel/builders配下と、.vercel/cache配下のファイル(pnpm のキャッシュディレクトリはlockfile-verified.jsonlのみ保持)
逆に .vercel/output はキャッシュされません。どのファイルをキャッシュするかをユーザー側で指定することは、現時点ではできません。
キャッシュキーは、チーム/プロジェクト/フレームワークプリセット/ルートディレクトリ/Node.js バージョン/パッケージマネージャ/Git ブランチの組み合わせから作られます。この中のどれか一つでも変えると次のビルドはキャッシュなしになります。Node.js のバージョンアップ直後にビルドが遅いのは、この仕様によるものです。新しいブランチは自前のキャッシュを持たないため、最新の本番デプロイのキャッシュを使って最初のプレビューを作ります。
影響が大きいのはどんなプロジェクトか
今回の変更で状況が変わりやすいのは、キャッシュが従来の上限をわずかに超えていたプロジェクトです。典型的には次のようなケースが該当します。
- Next.js 16.3 以降:
next buildで Turbopack の永続キャッシュがデフォルト有効になり、.next/cache/turbopackに書き出されます。Vercel は.next/cacheを復元するため、大規模アプリではキャッシュが肥大化しやすくなりました - モノレポ: 複数パッケージの
node_modulesがすべてキャッシュ対象になるため、合計サイズが膨らみます - 複数プラットフォーム向けのネイティブパッケージを入れている構成: Linux のビルドマシンでは使わない darwin/win32 向けバイナリまでインストールしていると、その分がそのままキャッシュサイズに乗ります
一方、キャッシュがもともと数百 MB で収まっているサイトであれば、今回の変更で体感が変わることはほぼありません。
自分のプロジェクトの現状を確認する手順
「効果があったかどうか」は推測せず、数値で確認できます。
- デプロイの詳細ページのサマリーで、保存されたビルドキャッシュのサイズと上限への近さを確認します。CLI では
vercel inspect <deployment>で同じ情報と課金対象時間・vCPU 数が見られます - ビルドログで、キャッシュが復元されたかどうかを確認します。以前は上限超過時に「クリーンな状態から開始する」旨が出ていました
- プロジェクトの Observability にある Build Diagnostics で、クローン・インストール・ビルドコマンドのどの工程に時間がかかっているかを切り分けます
- 環境変数
VERCEL_BUILD_SYSTEM_REPORTを1にすると、毎回のビルドでシステムレポートが出力され、ソースコード・node_modules・出力のディスク使用量の内訳や 100 MB 超のファイルが分かります
すでに上限超過でキャッシュを捨てていたプロジェクトなら、今回の変更後の最初のビルドでキャッシュが保存され、その次のビルドからインストール時間が短くなるはずです。2 回分のデプロイを比較してください。
上限が上がっても「大きいキャッシュ」は無料ではない
ここが判断の分かれ目です。Vercel はビルド後にキャッシュをアップロードしますが、その時間は課金対象のビルド時間に含まれます。Build CPU Minutes は 1 CPU 分あたり $0.0035 で、課金対象の時間を分単位に切り上げてマシンの vCPU 数を掛けて計算されます。つまりキャッシュが大きいほど、毎回のビルドにアップロードのコストが乗ります。
判断基準はシンプルです。キャッシュによって短縮されるインストール・コンパイル時間が、キャッシュのアップロードにかかる時間を上回っているか。上回っていなければ、上限に収まっていてもキャッシュを小さくするほうが得です。
縮める手段としては、モノレポでのフィルタードインストール(例: pnpm install --filter web...)で node_modules を絞る、ビルドマシンで使わないプラットフォーム向けのネイティブパッケージを入れない、といった方法があります。Next.js の Turbopack 永続キャッシュについては、Vercel の公式ガイドが「上限を超え続ける場合、またはアップロード時間が暖かいコンパイルで節約できる時間を上回る場合」は experimental.turbopackFileSystemCacheForBuild を false にする選択肢を挙げています。なお、無効化してもすでに保存済みのフォルダは復元・アップロードされ続けるため、「Use existing Build Cache」のチェックを外して一度再デプロイする必要があります。Next.js 16.4 で Turbopack のディスクキャッシュサイズは削減されているため、まずはアップグレードして再計測するのが先です。
キャッシュを意図的に使わない方法としては、再デプロイ時に「Use existing Build Cache」を外す、vercel --force、環境変数 VERCEL_FORCE_NO_BUILD_CACHE=1(復元をスキップ)や VERCEL_FORCE_NO_BUILD_CACHE_UPLOAD=1(アップロードをスキップ)があります。ただしキャッシュ破損が疑われる場合などに限定し、常用はしないのが無難です。キャッシュなしの再デプロイでは Turborepo や Nx のリモートキャッシュも除外されます。
いま取るべきアクション
やることは 3 つです。まず直近のデプロイサマリーか vercel inspect でキャッシュサイズを確認し、以前の上限(1.5 / 3 / 4.75 GB)を超えて破棄されていなかったかを見ます。超えていたなら、今回の変更だけでインストール時間が短くなる可能性が高いので、次の 2 回のビルドで課金対象時間を比較します。収まっていたなら、キャッシュのアップロード時間と節約できている時間を天秤にかけ、必要なら依存関係や Turbopack キャッシュを絞ります。
なお、Vercel のナレッジベース記事など一部のページには旧上限の記述が残っている場合があります。数値を確認するときは ドキュメントの Limits ページを基準にしてください。
まとめ
ビルドキャッシュ上限の 5 GB への引き上げは、設定不要で全プランに適用される一方、効果があるかどうかはプロジェクトのキャッシュサイズ次第です。まずは現状のサイズとビルド時間を測り、キャッシュを「効かせる」のか「軽くする」のかを決めてください。Next.js や Vercel 上でのビルド時間・ビルドコストの改善、モノレポ構成の見直しなどでお困りの場合は、chot Inc. のお問い合わせからご相談ください。
出典
この記事に関連するchot Inc.の支援
chot Inc.は日本初のVercel公式パートナーとして、Next.jsを中心としたWebサイト・Webアプリケーションの開発を支援しています。Vercelの導入・契約・運用の見直しはVercel公式パートナー開発支援で、Next.jsによる新規開発や既存システムからの技術移行はモダンWeb開発で紹介しています。


