「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 nextConfigcacheComponents を有効にすると、'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で即時反映
