(Article)Est. 2023 — Tokyo, JP

BLOG

← Back to Blog
Next.js

Next.js 16 × microCMS:Cache Componentsと"use cache"で記事を配信する

コーポレートサイト「NEXT BASE」(旧 NEXT TECH)は、Next.js の App Router と microCMS で作っています。Next.js 16 に上げたのに合わせて、記事の配信を ISR(revalidate = 60)から Cache Components に切り替えました。データは "use cache" でキャッシュし、microCMS の Webhook で記事を公開したと同時にキャッシュを作り直します。以前は反映まで最大 60 秒かかっていましたが、今は公開すればすぐに反映されます。

リポジトリ:Nextjs-TypeScript-MicroCMS-Site2 / デモ:https://next-tech-trigger.vercel.app/

Cache Components を有効にする

next.config.ts で cacheComponents を有効にします。

// next.config.ts
import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  // データは "use cache" + cacheLife / cacheTag でキャッシュする(lib/microcms.ts)
  cacheComponents: true,
  // リンク先は、静的な外枠だけを先読みする
  partialPrefetching: true,
  // <Link href> と router.push() の行き先を型でチェックする
  typedRoutes: true,
}

export default nextConfig

Cache Components では、「何をキャッシュするか」をページ単位の設定ではなく、関数やコンポーネントに "use cache" を書いて決めます。typedRoutes も合わせて有効にしたので、存在しないページへのリンクを書くと型エラーになります。

取得処理に "use cache" を書く

// lib/microcms.ts
import 'server-only'
import { cacheLife, cacheTag } from 'next/cache'
import { createClient } from 'microcms-js-sdk'
import { BLOG_TAG, blogTag } from './cache-tags'

const client = createClient({ serviceDomain, apiKey })

export const getBlogs = async (limit = 100): Promise<BlogSummary[]> => {
  'use cache'
  cacheLife('hours')   // 1時間ごとに裏で作り直す
  cacheTag(BLOG_TAG)   // Webhook からまとめて無効にするための目印

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

export const getBlog = async (id: string): Promise<Blog | null> => {
  'use cache'
  cacheLife('hours')
  cacheTag(BLOG_TAG, blogTag(id))
  try {
    return await client.getListDetail<Blog>({ endpoint: 'blogs', contentId: id })
  } catch {
    return null
  }
}

ポイントは 3 つです。

  • 先頭の import 'server-only' で、このファイルを Client Component から読み込むとビルドエラーになるようにしています。API キーを誤ってブラウザに送る事故を防げます
  • cacheLife('hours') で、キャッシュは 1 時間ごとに裏で作り直されます。Webhook が届かなかったときの保険です
  • cacheTag で、一覧には blogs、記事には blogs-記事ID という目印を付けています。記事が更新されたら、その目印のキャッシュだけを無効にできます

一覧では fields に category.name のように参照先の項目まで指定できます。本文を含めないので、レスポンスがかなり軽くなります。

Webhook で、公開と同時にキャッシュを作り直す

microCMS の Webhook(カスタム通知)の送信先を /api/revalidate にし、届いたら revalidateTag を呼びます。

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

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

  const body = await req.text()
  const signature = req.headers.get('x-microcms-signature') ?? ''
  const expected = createHmac('sha256', secret).update(body).digest('hex')

  const a = Buffer.from(signature)
  const b = Buffer.from(expected)
  if (a.length !== b.length || !timingSafeEqual(a, b)) {
    return NextResponse.json({ error: 'Invalid signature' }, { status: 401 })
  }

  let id: string | undefined
  try {
    id = (JSON.parse(body) as { id?: string }).id
  } catch {
    // 本文が読めなくても、一覧のキャッシュは作り直す
  }

  revalidateTag(BLOG_TAG, 'max')
  if (id) revalidateTag(blogTag(id), 'max')

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

この URL は誰でも叩けるので、microCMS が付けてくる署名(x-microcms-signature)を必ず確かめます。microCMS の管理画面で設定したシークレットで本文の HMAC を計算し、届いた署名と一致したときだけキャッシュを無効にします。比べるときは === ではなく timingSafeEqual を使い、比較にかかる時間から署名を推測されないようにしています。

revalidateTag の 2 つ目の引数 'max' は、キャッシュを「古い」と印を付ける指定です。次のアクセスでは古いページをすぐに返しつつ、裏で新しいページを作ります。

記事ページ

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

export default async function Article({ params }: PageProps<'/articles/[id]'>) {
  const { id } = await params
  const [post, posts] = await Promise.all([getBlog(id), getBlogs()])
  if (!post) notFound()
  // ...
}

ビルド時点の記事は generateStaticParams で事前に生成し、その後に公開された記事は初回のアクセスで生成してキャッシュします。以前書いていた export const revalidate = 60 と export const dynamicParams = true は、Cache Components では不要になりました。

Next.js 16 では params が Promise になったので、await params で取り出します。PageProps<'/articles/[id]'> は Next.js が自動で作る型で、ルートの形から params の型が決まります。

メタデータも記事から作る

export async function generateMetadata({ params }: PageProps<'/articles/[id]'>): Promise<Metadata> {
  const { id } = await params
  const post = await getBlog(id)
  if (!post) return { title: 'BLOG' }
  const description = toPlainText(post.content).slice(0, 110) || undefined
  const image = post.eyecatch ? cmsImage(post.eyecatch.url, 1200) : undefined
  return { title: post.title, description, openGraph: { title: post.title, description, images: image ? [image] : undefined } }
}

本文の HTML からタグを除いた先頭 110 文字を description にし、アイキャッチを OGP 画像にしています。getBlog はキャッシュされているので、ページ本体と generateMetadata で 2 回呼んでも、microCMS へのリクエストは増えません。

前後の記事リンク

一覧は新しい順なので、配列の 1 つ後ろが「前の記事(古い)」、1 つ前が「次の記事(新しい)」です。記事と一覧は Promise.all で並行して取得しています。

const index = posts.findIndex((p) => p.id === post.id)
const prev = index >= 0 ? posts[index + 1] : undefined
const next = index > 0 ? posts[index - 1] : undefined

つまずいた点:フッターの年

Cache Components を有効にすると、事前に生成するページの中で new Date() をそのまま使うとエラーになります。フッターの「© 2026」がこれに当たりました。年を返す小さな関数にも "use cache" を付け、1 日ごとに作り直すようにして解決しました。

// lib/date.ts
export async function getCurrentYear() {
  'use cache'
  cacheLife('days')
  return new Date().getFullYear()
}

まとめ

  • cacheComponents: true にし、キャッシュは取得処理に "use cache" を書いて決める
  • cacheLife で定期的に作り直し、cacheTag で目印を付ける
  • microCMS の Webhook で revalidateTag を呼び、公開と同時に反映する。署名の確認は必須
  • params は await で取り出し、型は PageProps に任せる