2026年10月30日ブログ

高い Next.js メモリ使用量: 診断方法

PRNext

メモリが増加し、サイトの速度が低下し、プロセスが再起動されます。ヒープ制限を引き上げる前に、何がいつ増加したかを確認してください。原因としては、ビルド、キャッシュ、大きな応答、または到達可能なままのオブジェクトが考えられます。

このガイドは再現可能な調査に従っています。使用率が高いだけではリークは確立されず、サーバーの測定値はブラウザータブのメモリから分離されている必要があります。

プロセスとフェーズを特定する

ノードと Next.js のバージョン、起動コマンド、コンテナーまたはサービスの制限を記録します。次の開発プロセスでは、次回の開始を記述していないコンパイルツールが保持されます。次回のビルド中に失敗する場合は、また別のケースになります。

再起動する前にログを読んでください。 V8 ヒープエラーとシステムのメモリ制限により強制終了されたプロセスは別の信号です。タイムスタンプ、PID、ワークロードを保持します。 VPS 全体のチャートだけでは、メモリを Next.js に帰すことはできません。

Terminal

node --version
npm ls next react react-dom
ps -eo pid,ppid,rss,comm --sort=-rss

ヒープ、RSS、サービスメモリを比較する

process.memoryUsage() は、rss、heapused、heapTotal、external、arrayBuffers などの値をバイト単位で報告します。調査しているアプリケーションプロセス内で、たとえばプライベートインストルメンテーションを通じて呼び出します。ノード -e を同時に実行すると、その新しいプロセスのみが測定されます。

RSS が High のままで収集後に heapused が低下した場合、JavaScript リークは確立されません。ネイティブ割り当て、バッファー、およびアロケーターの動作も調査する価値があります。複数のプロセスの場合は、サービスグループ全体も観察します。診断エンドポイントを非公開にしておきます。

インストルメンテーション.node.js

const timer = setInterval(() => {
  const { rss, heapUsed, external } = process.memoryUsage();
  console.log(JSON.stringify({
    event: "memory-sample",
    pid: process.pid,
    rss, heapUsed, external,
    at: new Date().toISOString()
  }));
}, 10000);
timer.unref();