Next.js 16 App Router × microCMS:Cache ComponentsとWebhookで前後記事リンクまで作る

「NEXT BASE」は Next.js と microCMS で作ったポートフォリオです。Next.js 16・React 19 に上げたのに合わせて、Pages Router から App Router に移行しました。記事は Cache Components('use cache')でキャッシュして静的に配信し、microCMS で公開した記事は Webhook ですぐに反映します。前後の記事へのリンクや目次も含めて、データの取得まわりを紹介します。

リポジトリ:Nextjs-TypeScript-MicroCMS-Site / デモ:https://nextbase-gsap.vercel.app/

Pages Router から何が変わったか

Pages Router

App Router(このサイト)

getStaticProps

async な Server Component で直接取得し、'use cache' でキャッシュ

getStaticPaths

generateStaticParams

revalidate(ISR)

cacheLife + Webhook からの revalidateTag

next/head

Metadata API(metadata / generateMetadata)

_app.tsx / _document.tsx

app/layout.tsx

pages/api

app/api/…/route.ts と Server Action

いちばん大きいのは、データの取得がコンポーネントの中に移ったことです。getStaticProps で取得して props で渡す代わりに、ページ自体を async 関数にして、その場で await します。

next.config.ts

import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  // 'use cache' / cacheLife / cacheTag + Partial Prerendering
  cacheComponents: true,
  // 全ページを静的に生成できるため不要。無効にすると、存在しない記事に
  // 共通の外枠を先に返さず、notFound() で正しく 404 ステータスを返せる
  partialPrefetching: false,
  // 自動メモ化(useMemo / useCallback を手書きしない)
  reactCompiler: true,
  typedRoutes: true,
  images: {
    formats: ['image/avif', 'image/webp'],
    remotePatterns: [{ protocol: 'https', hostname: 'images.microcms-assets.io' }],
  },
}

export default nextConfig

cacheComponents を有効にすると、'use cache' と cacheLife・cacheTag が使えるようになります。typedRoutes を有効にしておくと、<Link href> のリンク先や、後で出てくる PageProps<'/articles/[id]'> に型が付きます。remotePatterns は、microCMS の画像を next/image で最適化するための許可設定です。

データの取得は lib/microcms.ts にまとめる

microCMS の取得処理は 1 つのファイルにまとめ、関数ごとに 'use cache' を付けています。cacheLife('minutes') で数分ごとに作り直し、cacheTag で「どのキャッシュか」に名前を付けておきます。名前を付けておくと、後で Webhook からそのキャッシュだけを無効にできます。

import 'server-only'
import { cacheLife, cacheTag } from 'next/cache'
import { createClient } from 'microcms-js-sdk'
import type { Blog, BlogSummary } from '@/types/blog'

/** microCMS の更新時に Webhook から無効化するキャッシュタグ */
export const BLOG_TAG = 'blogs'

/** 公開日の新しい順に記事一覧を取得 */
export async function getBlogs(): Promise<BlogSummary[]> {
  'use cache'
  cacheLife('minutes')
  cacheTag(BLOG_TAG)

  const { contents } = await getClient().getList<Blog>({
    endpoint: 'blogs',
    queries: {
      limit: 100,
      orders: '-publishedAt',
      fields: 'id,title,publishedAt,createdAt,eyecatch,category.name',
    },
  })
  return contents.map(toSummary)
}

/** 記事詳細を取得(存在しなければ null) */
export async function getBlog(id: string): Promise<Blog | null> {
  'use cache'
  cacheLife('minutes')
  cacheTag(BLOG_TAG, `${BLOG_TAG}:${id}`)

  try {
    return await getClient().getListDetail<Blog>({ endpoint: 'blogs', contentId: id })
  } catch {
    return null
  }
}

ポイントは 3 つです。

  • 先頭の import 'server-only' で、このファイルをブラウザ向けのコードから import するとビルドエラーになるようにしています。API キーを誤ってブラウザに送らないための保険です。
  • 一覧では fields で必要な項目だけを取り、本文(content)は取得しません。一覧用には本文を除いた軽い型 BlogSummary に変換して返します。
  • 記事が見つからないときは例外を投げずに null を返し、ページ側で 404 にします。

記事ページ:generateStaticParams と 404

getStaticPaths の代わりに generateStaticParams で記事 ID の一覧を返すと、ビルド時にすべての記事ページが生成されます。Next.js 15 以降、params は Promise になったので await してから使います。

// app/articles/[id]/page.tsx
export async function generateStaticParams() {
  const posts = await getBlogs()
  return posts.map((p) => ({ id: p.id }))
}

export async function generateMetadata({ params }: PageProps<'/articles/[id]'>): Promise<Metadata> {
  const { id } = await params
  const post = await getBlog(id)
  if (!post) return { title: 'Page Not Found' }
  const description = toPlainText(post.content).slice(0, 110) || undefined
  return {
    title: post.title,
    description,
    alternates: { canonical: `/articles/${id}` },
    openGraph: { type: 'article', title: post.title, description, publishedTime: post.publishedAt },
  }
}

export default async function ArticlePage({ params }: PageProps<'/articles/[id]'>) {
  // Suspense の外で取得して notFound() を呼ぶと、存在しない記事に 404 ステータスを返せる
  const { id } = await params
  const [post, posts] = await Promise.all([getBlog(id), getBlogs()])
  if (!post) notFound()
  // ...
}

generateMetadata で記事ごとのタイトルと説明文を作ります。getBlog はキャッシュされているので、メタデータとページ本体で 2 回呼んでも microCMS へのリクエストは 1 回で済みます。

前後の記事へのリンク

Pages Router のころは getStaticProps の中で前後の記事を探していました。今はページの中で、新しい順に並んだ一覧から自分の位置を探すだけです。一覧もキャッシュから返るので、記事ごとに microCMS へ問い合わせることはありません。

// 一覧は新しい順: PREV = ひとつ古い記事 / NEXT = ひとつ新しい記事
const index = posts.findIndex((p) => p.id === id)
const prev = index >= 0 ? posts[index + 1] : undefined
const next = index > 0 ? posts[index - 1] : undefined

本文の見出しから目次を作る

本文の h2 から目次を作り、見出しが 2 つ以上ある記事だけに表示しています。microCMS のリッチエディタは h2 に id を付けますが、無い場合は補います。

// lib/toc.ts
export const buildToc = (html: string): { html: string; toc: TocItem[] } => {
  const toc: TocItem[] = []
  const out = html.replace(/<h2([^>]*)>([\s\S]*?)<\/h2>/g, (_m, attrs: string, inner: string) => {
    const existing = attrs.match(/\sid="([^"]+)"/)?.[1]
    const id = existing ?? `section-${toc.length + 1}`
    toc.push({ id, text: decode(inner.replace(/<[^>]+>/g, '')).trim() })
    return `<h2${existing ? attrs : `${attrs} id="${id}"`}>${inner}</h2>`
  })
  return { html: out, toc }
}

Webhook で公開と同時に反映する

cacheLife('minutes') だけでも数分で新しい内容になりますが、公開した瞬間に反映させたいので、microCMS の Webhook から /api/revalidate を呼んでいます。署名を HMAC-SHA256 で確かめてから、revalidateTag で一覧と該当記事のキャッシュを無効にします。

// app/api/revalidate/route.ts
import { createHmac, timingSafeEqual } from 'node:crypto'
import { revalidateTag } from 'next/cache'
import { BLOG_TAG } from '@/lib/microcms'

export async function POST(request: Request) {
  const secret = process.env.MICROCMS_WEBHOOK_SECRET
  if (!secret) return Response.json({ error: 'Webhook is not configured' }, { status: 501 })

  const body = await request.text()
  const signature = request.headers.get('x-microcms-signature') ?? ''
  const expected = createHmac('sha256', secret).update(body).digest('hex')
  const valid =
    signature.length === expected.length && timingSafeEqual(Buffer.from(signature), Buffer.from(expected))
  if (!valid) return Response.json({ error: 'Invalid signature' }, { status: 401 })

  let id: string | undefined
  try {
    id = (JSON.parse(body) as { id?: string }).id
  } catch {
    // body が JSON でなくても一覧は更新する
  }

  revalidateTag(BLOG_TAG, { expire: 0 })
  if (id) revalidateTag(`${BLOG_TAG}:${id}`, { expire: 0 })

  return Response.json({ revalidated: true, id: id ?? null })
}

署名の比較には、文字列の === ではなく timingSafeEqual を使います。比較にかかる時間から正しい署名を推測されるのを防ぐためです。microCMS 側では、API設定 → Webhook → カスタム通知 に URL とシークレットを登録します。

サイトマップと OG 画像

App Router では、app/sitemap.ts と app/robots.ts から sitemap.xml と robots.txt が生成されます。サイトマップは getBlogs() の一覧から記事の URL を並べています。サイト共通の OG 画像は app/opengraph-image.tsx で next/og の ImageResponse を使って生成し、記事ページでは microCMS のアイキャッチを使います。

まとめ

  • データの取得は Server Component の中で行い、'use cache'・cacheLife・cacheTag でキャッシュする
  • import 'server-only' で API キーを扱うファイルをサーバー専用にする
  • 記事ページは generateStaticParams で生成し、見つからなければ notFound()
  • 前後の記事はキャッシュされた一覧から探す
  • Webhook の署名を確かめてから revalidateTag で即時反映