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

問題の概要
開発モード(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();
}
動作確認手順
- ローカルで本番ビルドを実行(
npm run build && npm start)。 - ブラウザで
http://localhost:3000を開き、DevTools のコンソールに LCP オブジェクトが出力されることを確認。 - 同時に
/api/web-vitalsのログに同一ペイロードが届いているかチェック。 - 数分待って 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 データが届くようになります。
元記事: https://dev.to/mahdi_benrhouma_fe1c6005/fix-lcp-not-working-in-production-23c1