Hika Design logo
Home >Blog >(React)ハイドレーションエラーを防...
ブログトップ画像

フロントエンド

11/7/2026

(React)ハイドレーションエラーを防ぐNext.jsのdynamicインポートとは?

15

1. そもそもハイドレーションエラーとは?どんな時に起きるの?

ハイドレーションエラーとは、ReactやNext.jsなどのWebフレームワークで、サーバー側で生成されたHTMLと、クライアント(ブラウザ)側で最初にレンダリングされた内容が一致しないときに発生するエラーのことです。
例えば、個人開発中のアプリで、こんなエラーが発生しました。これは、画面上に、リアルタイムの時間を表示する、時計機能の開発中に生じたものです
Uncaught Error: Hydration failed because the server rendered text didn't match the client. As a result this tree will be regenerated on the client. This can happen if a SSR-ed Client Component used:

...(省略)...

<RealTimeClock>
  <div>
    <p>
+     20:44:22
-     20:44:21
「Hydration」と記載があります!出ました!これがハイドレーションエラーです!
エラーメッセージの下を見てみると、原因がはっきり分かります。
  • - 20:44:21(サーバーが作ったHTMLの時間)
  • + 20:44:22(ブラウザでJavaScriptが動き出した瞬間の時間)
サーバー側で生成されたHTMLの時間と、ブラウザ側で最初にレンダリングされた時の時間が異なっているぞということで、Reactが怒っている状態です
この時計コンポーネントでは、setInterval()関数で1秒ごとにリアルタイムの時間を取得しているので、サーバー生成時とレンダリング時で時間が異なってしまうのは、やむを得ないんですよね、、、(汗) でもNext.jsのとある機能を使えば大丈夫です!

2. ハイドレーションエラーを防ぐdynamicインポートとは何??

この、ハイドレーションエラーを防ぐNext.jsの機能として、dynamicインポートというのがあります!dynamicインポートを活用することで、時計コンポーネントをサーバー側でレンダリングさせず、「ブラウザ側だけで読み込む」という設定ができ、ハイドレーションエラーを回避することができました
使い方は、親コンポーネントから時計コンポーネントを呼び出す際に、dynamic()関数を設定するだけです。
'use client'; // 🟢 App Router環境で ssr: false を使う場合は必須!
import dynamic from 'next/dynamic';

// 🟢 時計コンポーネントをブラウザ専用(SSRオフ)として読み込む
const RealTimeClock = dynamic(() => import('./RealTimeClock'), {
  ssr: false, // サーバーサイドレンダリングを無効化
});
インポート時に、{ ssr: false } を指定することで、Next.jsが「このコンポーネントはサーバー側では一切組み立てず、ブラウザ(ユーザーの画面)に届いてから組み立てを開始してね」という動きに設定できます。
これで、ハイドレーションエラーもバッチリ解消しました〜✨

3. 終わりに

Reactチュートリアル等で馴染みのあるハイドレーションエラーを、setInterval()を使った時計機能実装時に、実際に体験できたのは良い経験でした!dynamicインポートで一斉解決できるNext.js、便利です
プロフィールアイコン小

Hika

UI/UXデザインとフロントエンドを学びながら、React / Next.js / TypeScript / Supabase を使ってWebアプリを個人開発しています。

Hika Design logo
プライバシーポリシー