Next.js 16の概要
Next.js 16はReact 19を前提としたメジャーリリースです。このブログ(ekusiadadus.com)をNext.js 16 + next-intl + MDX構成で構築・移行する過程で確認した変更点と、実運用上の注意点をまとめます。
主要な変更点
1. params / searchParams の完全非同期化
Next.js 15では後方互換の警告付きで同期アクセスが可能でしたが、Next.js 16ではページ・レイアウト・generateMetadata に渡される params と searchParams がすべて Promise になりました。
interface Props {
params: Promise<{ locale: string; slug: string }>;
}
export async function generateMetadata({ params }: Props) {
const { locale, slug } = await params;
// ...
}
export default async function BlogPostPage({ params }: Props) {
const { locale, slug } = await params;
// ...
}同様に cookies()、headers()、draftMode() もすべて await が必須です。既存のNext.js 14/15プロジェクトをアップグレードする場合は、公式のcodemod(npx @next/codemod@canary next-async-request-api .)で機械的に書き換えるのが確実です。
2. React Compiler の統合
React Compilerが安定版として統合され、next.config.ts の reactCompiler: true で有効化できるようになりました。
// Before: 手動でのメモ化
const MemoizedComponent = React.memo(({ data }) => {
const processed = useMemo(() => transform(data), [data]);
return <div>{processed}</div>;
});
// After: ビルド時にコンパイラが依存グラフを解析して自動メモ化
function Component({ data }) {
const processed = transform(data);
return <div>{processed}</div>;
}ただし、すべての useMemo / useCallback を無条件に削除できるわけではありません。以下のようなケースでは引き続き明示的な制御が必要です。
- 外部ライブラリやカスタムフックが参照同一性(referential equality)をトリガーに副作用を実行している場合
- 計算コストが極めて高く、コンパイラのヒューリスティックに任せず確実にキャッシュ境界を固定したい場合
3. middleware.ts から proxy.ts への移行
これまでEdge Runtimeの制約(Node.jsネイティブAPIが使えない、バンドルサイズ制限が厳しい)で問題になりやすかった middleware.ts が、リクエスト境界の役割を明確にするため proxy.ts(エクスポート関数名も proxy)に整理されました。
import createMiddleware from "next-intl/middleware";
import { routing } from "./i18n/routing";
export default createMiddleware(routing);
export const config = {
matcher: ["/((?!api|_next|_vercel|admin|.*\\..*).*)"],
};next-intl などのルーティングライブラリを使う場合も、不要な静的アセットやAPIルートにマッチャーが当たらないよう config.matcher を最小限に絞ることで、リクエストごとのオーバーヘッドを抑えられます。
4. generateStaticParams と多言語MDXビルドの注意点
App Routerで [locale]/blog/[slug] のような2段の動的セグメントを静的生成(SSG)する場合、上位の [locale] と下位の [slug] の組み合わせを generateStaticParams で網羅する必要があります。
export function generateStaticParams() {
const locales = ["ja", "en"] as const;
return locales.flatMap((locale) =>
getAllPosts(locale).map((post) => ({
locale,
slug: post.slug,
}))
);
}また、ページコンポーネントの先頭で setRequestLocale(locale) を呼ばないと、getTranslations() が動的レンダリング(リクエスト時解決)にフォールバックし、ビルド時に静的ページとして出力されなくなります。ビルドログのルート一覧で ● (SSG) になっているかを必ず確認するのが安全です。
まとめ
Next.js 16の変更は、暗黙的だったEdge Runtimeや同期Request APIを廃止し、明示的な非同期境界とコンパイラ最適化に寄せる内容になっています。移行時は params のPromise化と setRequestLocale によるSSG判定の2点を最初に確認すると手戻りがありません。