2026.11.21CMS・更新性

会社のサイトはNext.jsのensureStaticで静的に保つ

AUTHORCreavePlus 編集部
会社のサイトはNext.jsのensureStaticで静的に保つ
この記事の目次

Next.jsで作った会社のサイトにあとから部品を足していくと、気づかないうちにページが毎回サーバーで描かれるようになります。会社案内やブログのように全部のページが静的でよいサイトは、Next.js 16.4で入った ensureStatic をルートのlayoutに 'navigation' で書いて動的な部品が入ったらビルドで止めるのが弊社の結論です。反対にログインや会員ごとの表示があるサイトは、静的でよいフォルダのlayoutだけに付けるか付けないままで問題ありません。

この設定が今使える理由ははっきりしています。2026年10月6日のNext.js 16.4の発表で create-next-app で新しく作るアプリはCache Componentsが初期でオンになり、Next.js 17で標準になる予定と書かれました。Cache Componentsでは1つのページに静的な所と毎回描く所を混ぜられるので、静的のままにしたいページを守る設定が別に必要になります。

この記事では ensureStatic が何を止めるのかを公式の説明で確かめます。そのうえで2026年11月時点のNext.js 16.4とmicroCMSとVercelの組み合わせで、付けるページと外すページを分けてビルドで確かめる手順を書きます。

あとから足した部品でページは毎回サーバーで描かれるようになる

Cache Componentsを使うNext.jsでは、ページの中で1つの部品が cookies() を読むだけでその部品はリクエストのたびにサーバーで描かれます。Next.js公式のKeeping pages static(2026年10月6日更新)では、Cache Componentsは1つのルートに事前に描いた画面とキャッシュした中身とリクエストごとの中身を組み合わせられると説明しています。

この自由さはログインした人の名前を出すようなページには便利です。一方で全部が静的でよいサイトでも、あとから入れたテーマの切り替えやアクセスの集計の部品が cookies() や headers() を読むとそのページだけ毎回サーバーで描かれるようになります。表示は変わらないので、ビルドの結果を見ないと気づきません。

Next.js 16.4の発表でも、すべて静的なページを作りたい場合に1つの動的な部品がサイトの速さや費用を悪くすることがあると書かれています。

静的でよいサイトほど、静的でなくなったことに気づく手段を先に用意しておく必要があります。

ensureStaticはルート全体が静的でなければビルドを止める

ensureStatic はpageかlayoutから書き出す設定で、指定した範囲がリクエストのたびに描かれないことを求めます。Next.js公式のensureStaticの説明(2026年10月6日更新)によると値は 'auto'・'shell'・'prefetch'・'navigation'・false の5つで、初期は 'auto' です。

会社のサイトで使うのは 'navigation' です。'navigation' はルート全体を事前の描画で作ることを求める値で、next dev と next build の両方で確かめます。'shell' と 'prefetch' はPartial Prefetchingを使うときの細かい指定なので、全部が静的でよいサイトなら選ばなくて構いません。

ルートのlayoutに書くとアプリのすべてのルートに効きます。下の階層ではもっと厳しい値に変えられますが、ゆるい値に戻そうとするとビルドが失敗します。また cacheComponents がオンでないと ensureStatic を書いた時点でビルドが失敗します。

ルートのlayoutに 'navigation' を書けば、下の階層のページがあとから動的にされることを1行で止められます。

navigationで失敗になる書き方は4つある

ensureStatic = 'navigation' のページでは、次の4つを書くと <Suspense> で囲んでいてもビルドが失敗します。公式の説明に書かれているのは次のとおりです。

  • use cache の無い fetch やデータベースの呼び出しと connection()
  • cookies()・headers() とサーバー側の searchParams
  • use cache の中で expire が5分より短いか stale が30秒より短いか revalidate が0のもの
  • リクエストごとのデータを待つPromiseをClient Componentに渡すこと

この決まりは generateMetadata と generateViewport にも当てはまります。記事の詳細のような [slug] のルートでは generateStaticParams() を書き出し、少なくとも1つの値を返さないとビルドが失敗します。

microCMSから記事を取る関数は、use cache を付ければ事前に描けます。記事を更新したときの反映は関数に cacheTag でタグを付けておき、Route Handlerから revalidateTag を呼ぶ形がNext.js公式のcacheTagの説明(2026年11月18日更新)に書かれています。ブラウザの中だけで動く部品は <Suspense> の中なら使えます。

CMSの中身は use cache で取って訪問者ごとに変わる処理はブラウザ側に移せば、'navigation' のまま運用できます。

ensureStaticを付けるサイトと付けないサイト

付けるかどうかは、訪問者ごとに中身が変わるページがあるかどうかで決まります。社内で説明するときは次の表をそのまま使えます。

確かめること

ルートのlayoutに付ける

フォルダごとに付けるか付けない

ログインや会員ごとの表示

無い

ある

サーバーで読むcookies()やheaders()

使っていないかブラウザ側に移せる

サーバーで読む必要がある

CMSの中身の取り方

use cacheで取れる

リクエストのたびに最新を取る必要がある

下書きのプレビュー

無いか別のフォルダに分けられる

公開のページと同じルートで見る

4つとも左の列なら、ルートの app/layout.tsx に ensureStatic = 'navigation' を書いてください。1つでも右の列があるなら、静的でよいページだけをルートグループ((site) のようにかっこで囲んだフォルダ)にまとめてそのlayoutに書きます。ルートのlayoutに書いてしまうと、下の階層でゆるめられないので右の列のページがビルドで止まります。

反対にほとんどのページがログインした人向けの画面なら、ensureStatic は付けないままで問題ありません。付ける範囲は「訪問者ごとに変わらないページ」のフォルダに合わせて決めます。

ensureStaticを入れてビルドで確かめる手順

2026年11月時点のNext.js 16.4とApp Routerで試す前提の手順です。作業の前にGitで今の状態をコミットし、作業用のブランチを作ってから進めてください。

  1. 今の状態を残して作業用のブランチを作ります。
    git status
    git switch -c chore/ensure-static

    確かめ方:git status でコミットしていない変更が無いことを見ます。

  2. 16.4より前から使っているアプリなら next.config.ts で cacheComponents を有効にします。新しく作ったアプリは初期で入っています。
    import type { NextConfig } from 'next'
    
    const nextConfig: NextConfig = {
      cacheComponents: true,
    }
    
    export default nextConfig

    確かめ方:next build がこの時点で通るかを見ます。通らない場合はCache Componentsへの移行が先なので、Next.js公式のCache Componentsへの移行の説明を読んでから進めます。

  3. 静的でよい範囲のlayoutに1行足します。全部のページが静的でよいなら app/layout.tsx に書きます。
    export const ensureStatic = 'navigation'

    確かめ方:next dev で主なページを開き、エラーの画面が表示されないかを見ます。開発中はエラーが表示された部品のファイルと行が分かります。

  4. ビルドを実行します。失敗して原因の場所が分からないときは --debug-prerender を付けます。
    npx next build
    npx next build --debug-prerender

    確かめ方:ビルドの結果のルートの一覧で、守りたいページが ○(Static)で表示されていれば成功です。

  5. 失敗したら原因ごとに直します。CMSから取る関数には use cache と cacheTag を付け、訪問者ごとに変わる処理はブラウザ側の部品に移します。
    import { cacheTag } from 'next/cache'
    
    export async function getPosts() {
      'use cache'
      cacheTag('posts')
      const res = await fetch('https://your-service.microcms.io/api/v1/blogs', {
        headers: { 'X-MICROCMS-API-KEY': process.env.MICROCMS_API_KEY! },
      })
      return res.json()
    }

    確かめ方:もう一度 npx next build を実行して通るかを見ます。

  6. [slug] のルートに generateStaticParams() があり、記事のIDを1つ以上返しているかを確かめます。確かめ方:ビルドの結果に記事のURLが並んでいるかを見ます。
  7. 作業用のブランチをプッシュし、Vercelのプレビューで主なページの表示と問い合わせフォームの送信を確かめます。問題が無ければプルリクエストで本番のブランチに入れます。

やりがちな失敗は、microCMSの下書きのプレビューのページを公開のページと同じlayoutの下に置いたまま 'navigation' を書くことです。プレビューのようにリクエストごとに中身を変えるページは、静的のルートグループの外に置いてから設定してください。

弊社の判断と経験

弊社は作りを最初から決めず、状況によって手段を考えて費用と工数も含めて決めています。ensureStatic を付けるかどうかも上の表のように訪問者ごとに変わるページがあるかで決まるので、どのサイトにも同じ設定をすすめることはしません。

弊社のサイトもWordPressからmicroCMSとNext.jsに載せ替えましたが、全ての会社にNext.jsへの載せ替えをすすめることはしません。更新の担当やページの中身によってはWordPressのままの方がよい場合もあります。

弊社がやっていること

弊社は2017年から300件以上のサイトやシステムを作ってきました。Next.jsとmicroCMSでの制作と、WordPressからの載せ替えを引き受けています。WordPressからNext.jsに移したときに何が変わるかは安全面の違いを書いた記事で紹介しています。版上げをAIに任せるときに人が見る所は版上げの記事にまとめています。

上の表で4つとも左の列なら、この記事の手順は御社の中で進められるので弊社に頼む必要はありません。

載せ替えの進め方はWordPressからNext.jsへの載せ替えのページに、料金は料金の一覧にあります。設定を入れてよいか迷う場合は相談の窓口からご連絡ください。初回の30分は無料です。

よくある質問

ensureStaticはNext.js 16.3以前でも使えますか

使えません。ensureStaticはNext.js 16.4で入った設定なので、先に16.4以降に上げてからcacheComponentsを有効にしてください。

ensureStaticを付けるとmicroCMSの更新が反映されなくなりますか

反映できます。記事を取る関数にuse cacheとcacheTagを付けておき、microCMSのWebhook(更新したときに指定のURLへ知らせる機能)から呼ぶRoute HandlerでrevalidateTagを実行します。

以前のdynamic = 'force-static'と何が違いますか

force-staticはルートの描き方を選ぶ設定で、ensureStaticは静的でなくなったときにビルドを止める設定です。Cache Componentsを使うアプリではensureStaticで静的のままかを確かめます。

一部のページだけ毎回サーバーで描きたいときはどうしますか

静的でよいページをルートグループにまとめ、そのlayoutだけにensureStaticを書きます。ルートのlayoutに書くと下の階層でゆるめられないので、毎回描くページはグループの外に置きます。

RELATED