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)です。

app/not-found.tsx
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 です。

app/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 でも、フラグを付けない限り有効にはなりません。

next.config.ts
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 の中に置くと、画面は切り替わらず、開発時のサーバーログに未処理の拒否が出ます。

app/blog/[slug]/page.tsx
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 はそちらに替わります。

app/blog/not-found.tsx
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 も候補です。有効にするフラグは上の節と同じです。

app/[locale]/[...rest]/page.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 ページを作り込む理由です。

app/not-found.tsx(中身を足した版)
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 自体はサーバーコンポーネントのままにします。

components/NotFoundNumber.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 ページをコピーして使う方法

DesignLayer の「スタチュー 404」の詳細ページ。左でライブプレビューを確かめ、右の「Cursor 用にコピー」でソースをコピーできる
DesignLayer の「スタチュー 404」の詳細ページ。左でライブプレビューを確かめ、右の「Cursor 用にコピー」でソースをコピーできる

ここまでの手順で、仕組みとしての 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 で解説しています。

このガイドのコンポーネント

コンポーネントを見る →

関連ガイド