News Observation Lab for Future

Next.js の production ビルドで LCP が計測されない原因と対処法

Close-up of an AI-driven chat interface on a computer screen, showcasing modern AI technology.

問題の概要

開発モード(npm run dev)ではコンソールに LCP が表示されますが、本番ビルド(npm run build && npm start)や Vercel・Netlify・自己ホスト環境へデプロイすると、Vercel ダッシュボードやカスタム分析ツールの「Largest Contentful Paint」列が空白になります。

原因:reportWebVitals の未実装またはフィルタリング

Next.js は reportWebVitals 関数(Pages Router)または useReportWebVitals フック(App Router)がエクスポートされていることを前提に、Core Web Vitals(LCP、CLS、INP 等)を収集します。このエクスポートが無い、あるいは LCP を除外するロジックが入っていると、クライアント側で取得した指標がサーバーへ送信されません。

解決策:reportWebVitals エクスポートの追加

pages/_app.js(または App Router のエントリ)に、すべての指標を転送する reportWebVitals エクスポートを実装します。例として:

// pages/_app.js
export async function reportWebVitals(metric) {
  // 必要なら API エンドポイントへ POST
  await fetch('/api/web-vitals', {method: 'POST', body: JSON.stringify(metric)});
}

この関数は LCP を含む全指標を破棄せずに送信することが重要です。

受信用 API の作成

上記のエクスポートが POST する /api/web-vitals ルートを作成し、受け取ったペイロードをログ出力または保存します。

// pages/api/web-vitals.js
export default function handler(req, res) {
  if (req.method !== 'POST') return res.status(405).end();
  const metric = req.body;
  console.log('Web Vital received:', metric);
  res.status(200).end();
}

動作確認手順

  1. ローカルで本番ビルドを実行(npm run build && npm start)。
  2. ブラウザで http://localhost:3000 を開き、DevTools のコンソールに LCP オブジェクトが出力されることを確認。
  3. 同時に /api/web-vitals のログに同一ペイロードが届いているかチェック。
  4. 数分待って Vercel のダッシュボードや自社分析画面で LCP 列が埋まっていることを確認。

よくある落とし穴:LCP が除外されるケース

  • エクスポート内で if (metric.name === 'LCP') return; のように早期リターンしている。
  • 特定指標(例:CLS)のみ処理するロジックを書いており、他の指標は無視されている。

これらの条件分岐を削除し、すべての metric.name に対して送信処理を走らせます。

再発防止策:CI でのチェック

ESLint には reportWebVitals の有無を検証するルールがありません。そのため、簡易的なテストを CI に組み込みます。

// jest.test.js
import '../pages/_app';
test('reportWebVitals is exported', () => {
  expect(typeof window.__NEXT_DATA__.reportWebVitals).toBe('function');
});

テストが失敗すれば、リファクタリングでエクスポートが削除されたことが即座に判明します。

まとめ

production ビルドで LCP が計測されない主因は reportWebVitals の未実装または不適切なフィルタリングです。エクスポートを正しく追加し、API エンドポイントで受信を確認すれば、Vercel や任意の分析ツールに LCP データが届くようになります。

免責事項・利用上の注意

本サイトは情報提供および調査研究を目的としており、投資勧誘を目的とするものではありません。掲載情報には自動取得・自動翻訳・AI分析による内容が含まれます。投資判断はご自身の責任で行ってください。

詳細を確認する →