Next.js の not-found.tsx と notFound() の使い方
公開日: 2026年10月8日 · 読了目安 9 分
404 ページは app/not-found.tsx を置きます。データがなければ next/navigation の notFound() を呼びます。Next.js がそのファイルを表示します。
not-found.tsx はどう動きますか?
存在しない URL を開くと、Next.js は白い画面に「404」と「This page could not be found.」だけを出します。app 直下の not-found.tsx が、その画面を自分のデザインに差し替えます。
not-found.tsx は、Next.js が役割を決めている特別なファイルです。拡張子は .js でも .tsx でも同じです。中身はサーバーコンポーネントのまま書けます。ルートの app/layout.tsx の中に出るので、ヘッダーやフッターも付きます。props は受け取れません。
ルートの app/not-found.tsx には、Next.js 13.3 から仕事が2つあります。notFound() が一番上まで届いたときに表示することと、どのページにも一致しない URL を引き受けることです。フォルダの中に置いた not-found.tsx は、その範囲で notFound() が呼ばれたときだけ使われます。
この記事のコードは Next.js 15 向けです。このサイトの依存は next 15.5 系(package.json の ^15.5.27)です。
import Link from "next/link";
export default function NotFound() {
return (
<main className="mx-auto flex min-h-[70vh] max-w-xl flex-col items-center justify-center px-6 py-24 text-center">
<p className="text-sm font-semibold tracking-widest text-zinc-500">404</p>
<h1 className="mt-3 text-3xl font-semibold text-zinc-900">ページが見つかりません</h1>
<p className="mt-4 text-zinc-600">
URL が変わったか、ページが削除された可能性があります。
</p>
<Link
href="/"
className="mt-8 inline-flex min-h-11 items-center rounded-full bg-zinc-900 px-6 text-sm font-medium text-white hover:bg-zinc-700"
>
ホームに戻る
</Link>
</main>
);
}ルートの not-found.tsx に metadata を付ける
ルートの app/not-found.tsx は、metadata か generateMetadata を書き出せます。タブに「ページが見つかりません」と出れば、何が起きたかすぐ分かります。
公式ドキュメントが metadata を書けると明記しているのは、このルートのファイルと、後述の global-not-found.tsx です。
import type { Metadata } from "next";
export const metadata: Metadata = {
title: "ページが見つかりません",
};global-not-found.tsx は 15.4 以降の実験的な機能
Next.js 15.4.0 で、実験的な app/global-not-found.tsx が入りました。現行のファイル規約ドキュメントでも experimental のままです。next.config で experimental.globalNotFound を true にすると有効になります。
一致しない URL を、レイアウトを通さずにこのファイルだけで返します。html と body を含む完全な文書を返す必要があります。スタイルやフォントも、このファイル側で読み込みます。
使う場面は、ルートのレイアウトが複数あるときか、app/[locale]/layout.tsx のようにルート自体が動的なときです。それ以外は app/not-found.tsx で足ります。このサイトの Next.js 15.5 でも、フラグを付けない限り有効にはなりません。
import type { NextConfig } from "next";
const nextConfig: NextConfig = {
experimental: {
globalNotFound: true,
},
};
export default nextConfig;notFound() はいつ呼びますか?
app/blog/[slug]/page.tsx は、どんな文字列の URL にも一致します。記事が無い URL でも、このページが開きます。データが無いときに next/navigation の notFound() を呼ぶと、描画が止まり、いちばん近い not-found.tsx に切り替わります。
呼ぶ場所は、サーバーコンポーネント、サーバー関数(Server Functions)、Route Handler です。generateMetadata の中でも呼べます。Next.js の generateMetadata の説明に、redirect() と並べて書かれています。
notFound() は例外を投げます。return は要りません。戻り値の型は never なので、その先では post があるものとして TypeScript が扱います。try/catch で包むと 404 画面は出ません。await していない Promise の中に置くと、画面は切り替わらず、開発時のサーバーログに未処理の拒否が出ます。
import type { Metadata } from "next";
import { notFound } from "next/navigation";
import { cache } from "react";
import { getPostBySlug } from "@/lib/posts"; // 記事がなければ undefined を返す関数
// generateMetadata と page の取得を1回にまとめる
const getPost = cache(getPostBySlug);
type Props = { params: Promise<{ slug: string }> };
export async function generateMetadata({ params }: Props): Promise<Metadata> {
const { slug } = await params;
const post = await getPost(slug);
if (!post) notFound();
return { title: post.title, description: post.excerpt };
}
export default async function BlogPostPage({ params }: Props) {
const { slug } = await params;
const post = await getPost(slug);
if (!post) notFound();
return (
<article className="mx-auto max-w-2xl px-6 py-24">
<h1 className="text-3xl font-semibold">{post.title}</h1>
<div className="mt-8 leading-relaxed text-zinc-700">{post.body}</div>
</article>
);
}notFound() のコードのポイント
Next.js 15 では params が Promise です。await してから slug を取り出します。Next.js 14 は普通のオブジェクトでした
notFound() の後ろは実行されません
generateMetadata でも同じ呼び方で、無い記事に通常のタイトルが付きません
React の cache で包むと、タイトル用と本文用の取得が1回で済みます。fetch を使う場合は Next.js が同じ取得をまとめてくれます
ルートの一部だけ 404 にするには?
not-found.tsx はフォルダごとに置けます。app/blog/not-found.tsx を置くと、ブログの中で notFound() を呼んだときはこちらが使われます。いちばん近いファイルが選ばれるので、記事一覧へ戻るリンクなど、場所に合った案内を出せます。
このファイルは、一致しない URL 全体は受けません。サイトのどこにも一致しない URL を受けるのは、ルートの app/not-found.tsx です(Next.js 13.3 以降)。15.4 以降で実験的な global-not-found.tsx を有効にしたときは、一致しない URL はそちらに替わります。
import Link from "next/link";
export default function BlogNotFound() {
return (
<main className="mx-auto max-w-xl px-6 py-24 text-center">
<h1 className="text-2xl font-semibold text-zinc-900">記事が見つかりません</h1>
<p className="mt-4 text-zinc-600">記事の URL が変わったか、公開を終了した可能性があります。</p>
<Link
href="/blog"
className="mt-8 inline-flex min-h-11 items-center rounded-full bg-zinc-900 px-6 text-sm font-medium text-white"
>
記事の一覧へ
</Link>
</main>
);
}多言語サイト([locale])で 404 ページを出す
URL の先頭に言語が入るサイトでは、ページを app/[locale] の下に置きます。app/[locale]/not-found.tsx は、その中で notFound() を呼んだときに表示されます。どのページにも一致しない URL では使われません。
残りの URL をすべて受け止めるページを1つ作り、その中で notFound() を呼びます。next-intl などの説明でも使われている方法です。not-found.tsx は props を受け取れないので、表示する言語は使っているライブラリの方法に合わせます。
ルートのレイアウトが [locale] だけ、という構成なら、15.4 以降の実験的な global-not-found.tsx も候補です。有効にするフラグは上の節と同じです。
import { notFound } from "next/navigation";
// どのページにも一致しない URL をここで受け止め、[locale] の not-found.tsx を出す
export default function CatchAllPage() {
notFound();
}not-found.tsx は 404 ステータスを返しますか?
応答の送信が始まる前なら、Next.js は 404 を返します。送信が始まったあとなら、ステータスは 200 のまま、画面だけ not-found に替わります。どちらの場合も noindex のタグが入ります。自分で robots を書く必要はありません。
送信が先に始まる典型は、同じセグメントの loading.tsx が先にフォールバックを出すときと、データの確認を Suspense の内側に置いたときです。not-found.tsx は、そのセグメントの loading と page のあいだに描画されます。
本番に近い状態で、curl -I https://example.com/no-such-page のようにステータスを見ます。200 でもファイルの置き場所が間違っているとは限りません。先に画面を送り始めたあとは 200 のままです。検索結果に残さない役割は noindex が持ちます。
404 ページに置く中身を決める
404 ページの役目は、迷った人を次の行き先へ戻すことです。凝った演出より先に、次の3つを揃えます。
何が起きたかを短く伝える見出し(「ページが見つかりません」)
ホームへ戻るボタン
サイト内検索か、よく読まれているページへのリンク
検索は、GET で送るだけのフォームならサーバーコンポーネントのまま置けます。送信先の /search は、自分のサイトの検索ページに合わせて変えてください。
リンク切れで来た人を、ホームや人気ページへ戻す。ヘッダーと色をサイトと揃えて、壊れたサイトに見せない。ページが無いことを 404 として返して、存在しない URL を検索結果に残しにくくする。この3つが、404 ページを作り込む理由です。
import Link from "next/link";
const popular = [
{ href: "/blog", label: "ブログ記事の一覧" },
{ href: "/pricing", label: "料金プラン" },
{ href: "/contact", label: "お問い合わせ" },
];
export default function NotFound() {
return (
<main className="mx-auto max-w-xl px-6 py-24 text-center">
<p className="text-sm font-semibold tracking-widest text-zinc-500">404</p>
<h1 className="mt-3 text-3xl font-semibold text-zinc-900">ページが見つかりません</h1>
<p className="mt-4 text-zinc-600">URL が変わったか、ページが削除された可能性があります。</p>
<form action="/search" method="get" role="search" className="mt-8 flex gap-2">
<label htmlFor="q" className="sr-only">サイト内を検索</label>
<input
id="q"
name="q"
type="search"
placeholder="キーワードで探す"
className="min-h-11 flex-1 rounded-full border border-zinc-300 px-4 text-base"
/>
<button type="submit" className="min-h-11 rounded-full bg-zinc-900 px-5 text-sm font-medium text-white">
検索
</button>
</form>
<ul className="mt-10 space-y-1 text-sm">
{popular.map((item) => (
<li key={item.href}>
<Link href={item.href} className="inline-flex min-h-11 items-center underline underline-offset-4">
{item.label}
</Link>
</li>
))}
</ul>
<Link
href="/"
className="mt-8 inline-flex min-h-11 items-center rounded-full border border-zinc-300 px-6 text-sm font-medium"
>
ホームに戻る
</Link>
</main>
);
}404 ページの文言は読者を責めない
「URL が間違っています」と書くと、読者のせいに聞こえます。リンク切れは、サイト側の都合でも起きます。
「見つかりません」「移動した可能性があります」のように、事実だけを伝えます。イラストや遊びを入れる場合も、戻るためのリンクは最初に見える位置に置きます。
404 ページに控えめなアニメーションを付ける
大きな 404 の数字を、ふわっと浮かび上がらせるだけでも印象は変わります。動きは1回きりで、0.5秒前後に抑えます。
アニメーションには Motion(旧 Framer Motion)を使います。動く部分だけを別ファイルにして、先頭に "use client" を書きます。not-found.tsx 自体はサーバーコンポーネントのままにします。
"use client";
import { motion, useReducedMotion } from "motion/react";
export function NotFoundNumber() {
const reduceMotion = useReducedMotion();
return (
<motion.p
aria-hidden="true"
initial={reduceMotion ? false : { opacity: 0, y: 24 }}
animate={{ opacity: 1, y: 0 }}
transition={{ duration: 0.6, ease: "easeOut" }}
className="text-[8rem] font-semibold leading-none tracking-tight text-zinc-900 sm:text-[12rem]"
>
404
</motion.p>
);
}アニメーションのポイント
動きを減らす設定の人には initial を false にして、最初から表示した状態にする
大きな数字は飾りなので aria-hidden を付け、読み上げは h1 の見出しに任せる
戻るリンクの表示を、アニメーションが終わるまで遅らせない
Motion の基本は https://design-layer.com/ja/articles/nextjs-framer-motion-guide で解説しています。
404 ページでよくある失敗と公開前チェック
データがないのに空のページを返す。notFound() を呼ばないと、中身のないページが 200 のまま検索エンジンに届く
404 ページからホームへ自動で転送する。読者は何が起きたか分からず、ページがないことも伝わりにくい
戻るリンクがない、または画面の下の方にしかない
404 ページ全体に "use client" を書く。動く部分だけを切り出す
移動しただけのページを 404 にする。移動先があるなら next.config の redirects で転送する
notFound() を try/catch で握りつぶす。例外が止まると 404 画面は出ない
公開前に、存在しない URL を開いて表示を確かめます。next build のあとの本番と同じ状態で試すと確実です。
完成した 404 ページをコピーして使う方法

ここまでの手順で、仕組みとしての 404 ページはでき上がります。紙のような質感の背景、中央の石像、サイトに合わせた色まで自分で作ると時間がかかります。
見た目まで揃った画面が要るときは、スタチュー 404 を not-found.tsx に置けます。ざらついた紙地に巨大な 404 と石像の切り抜きを重ねたエラー画面で、文言・像の画像・アクセント色を差し替えられます。
詳細ページの「Cursor 用にコピー」を押すと、統合の指示・ライブプレビューの URL・本体の TSX・npm の依存がまとめてコピーされます。閲覧とライブプレビューは無料で、アカウントもカードも要りません。無料アカウントでは、コンポーネントのコピーは無料です。動画プロンプトは月1回です。Free では MCP に接続できません。Blocks と Templates は30日ビルドパス($19の1回払い、自動更新なし)、Lifetime Access(先着100名の$79の1回払い)、Plus(月額 $9、いつでも解約可)です。
Next.js の 404 ページについてよくある質問
not-found.tsx は画面のファイルです。notFound() は next/navigation の関数で、その画面を出すきっかけです。ファイルを置いただけでは、データが無い動的ルートは 404 になりません。
まとめ:Next.js で 404 ページを作る手順
app 直下に not-found.tsx を置く。一致しない URL と、上まで届いた notFound() の両方に使われる
データがない動的ルートでは notFound() を呼ぶ。return は要らない
フォルダの not-found.tsx は、その中で notFound() を呼んだときだけ
ステータスは、送信前なら 404、送信開始後は 200。noindex はどちらでも付く
[locale] のサイトでは、残りの URL を受け止めるページで notFound() を呼ぶ
まずは app 直下に not-found.tsx を置き、存在しない URL を開いてみてください。
データを待つあいだの画面は https://design-layer.com/ja/articles/nextjs-loading-screen-guide で解説しています。



