Next.jsのbuild時、特定のURLを除外する方法

build時に特定のURLを除外するコード（Next.js）

build時に特定のURLを除外する方法。

一番簡単なのはもちろん、該当のフォルダ（or ファイル）自体をappフォルダやpagesフォルダから取り除いてbuildする方法です。

しかしこれ以外の方法はないのかと、サッと調べてみました。

見た限りでは、Next.jsで特定のURLをnpm run buildコマンド実行時に除外するコードはないようです。

しかし「ユーザーからのアクセスを妨げる」という効果を実現する方法はいくつかあります。

⚫︎ monotein.base.shop/p/00005

そのひとつはpageExtensionsを使う方法ですが、もっとシンプルなのはredirectsを使うもので、コードは次のようになります（下記はnext.configの拡張子が.mjsのケース）。

// next.config.mjs

/** @type {import('next').NextConfig} */
const nextConfig = {
    redirects: () => {
        if(process.env.NODE_ENV === "production"){
            return[
                {
                    source: "/hobby/:path*",
                    destination: "/",
                    permanent: true,
                }
            ]
        }else{
            return []
        }
    },
    reactStrictMode: true,
}

export default nextConfig

next.configの拡張子が.jsのケースでは、最終行のexport部分のコードが変わり、次のようになります。

// next.config.js

/** @type {import('next').NextConfig} */
const nextConfig = {
    redirects: () => {
        if(process.env.NODE_ENV === "production"){
            return[
                {
                    source: "/hobby/:path*",
                    destination: "/",
                    permanent: true,
                }
            ]
        }else{
            return []
        }
    },
    reactStrictMode: true,
}

module.exports = nextConfig

next.configに上記コードを書くと、build後の公開時（production）、/hobbyを含む/hobbyから下のURLへのアクセスは、すべてトップページの/にリダイレクトされます。

Next.jsバックエンドAPIのURLなど、手元のコンピューターでの開発時には利用するものの、オンラインでの公開時には存在しなくてもいい、あるいは別の理由で除外したいURLなどを隠すときに使える方法です。

*Next.jsバージョン13以前のPagesフォルダでは、たとえば次のようにdestinationに404と書けば、404ページに遷移します（ファイル名を404.jsとした404ページを用意しておきましょう）。

source: "/hobby/:path*",
destination: "404",
permanent: true,

Next.jsの公開方法やApp Routerの全体像は、こちらのガイドでまとめて確認できます▼

Next.jsを実際にコードを書きながら理解したい人には、ぴったりの教材があります。

最新のNext.js Appルータとともに、API（Route Handlers）、Supabase、JWT、Cloudinaryなどを使って本格的なフルスタックアプリを開発する方法を、ビギナー向けにわかりやすく紹介しています（2026年時点で最新のNext.jsバージョン16使用）。

Next.jsでつくるフルスタックアプリ

【最新のNext.jsバージョン16をつかった本格アプリの開発手法がわかる入門書。Route Handlers使用】

Amazonで見る

⚫︎ monotein.base.shop/p/00005